遥测

Visual Studio Code 会收集遥测数据，这些数据用于帮助了解如何改进产品。例如，此使用数据有助于调试问题（如启动速度缓慢）并确定新功能的优先级。虽然我们感谢此数据提供的见解，但我们也知道并非每个人都希望发送使用数据，您可以按照禁用遥测报告中所述禁用遥测。您还可以阅读我们的隐私声明以了解更多信息。

遥测数据类型

VS Code 和此页面指的是关于遥测的三种不同类型的数据。

崩溃报告 - 崩溃报告在 VS Code 崩溃时收集诊断信息，并将其发送给 Microsoft 以帮助了解崩溃的原因以及将来需要进行哪些更改以防止崩溃。

错误遥测 - 错误遥测收集有关不会导致应用程序崩溃但意外的错误的信息。

使用数据 - 使用数据收集有关 VS Code 中功能的使用方式和执行情况的信息，这有助于我们确定未来产品改进的优先级。

禁用遥测报告

使用telemetry.telemetryLevel 用户设置，您可以使用单个设置控制我们发送的不同类型的遥测数据。下表列出了使用每个 telemetry.telemetryLevel 值发送的不同类型的数据

例如，如果您不想向 Microsoft 发送任何遥测数据，可以将telemetry.telemetryLevel 用户设置设置为 off。

从文件 > 首选项 > 设置中，搜索 telemetry，并将遥测：遥测级别设置设置为 off。这将静音 VS Code 今后的所有遥测事件。遥测信息可能已在您禁用设置之前收集并发送。

如果您使用 JSON 编辑器进行设置，请添加以下行

    "telemetry.telemetryLevel": "off"

扩展和遥测

VS Code 允许您通过安装 Microsoft 和第三方扩展来向产品添加功能。这些扩展可能会收集自己的使用数据，并且不受 telemetry.telemetryLevel 设置的控制。请查阅特定扩展的文档，了解其遥测报告以及是否可以禁用它。

扩展作者可以参考“对于扩展作者”部分，以获得有关在其扩展中实施遥测最佳实践的指导。

遥测事件的输出通道

如果您想在 VS Code 中查看遥测事件的发送情况，可以启用跟踪，它将记录遥测事件。使用开发人员：设置日志级别...命令并选择日志级别跟踪。要查看日志输出，请转到“输出”面板（⇧⌘U（Windows Ctrl+Shift+U，Linux Ctrl+K Ctrl+H）），然后从下拉列表中选择遥测。

跟踪遥测事件时，事件还会记录到本地文件 telemetry.log 中，您可以使用开发人员：打开日志文件...命令并从下拉列表中选择遥测来查看该文件。

查看所有遥测事件

如果您想查看 VS Code 可能发送的所有可能的遥测事件，可以在 CLI 中使用 --telemetry 标志。这将生成 JSON 报告，然后您可以在 VS Code 中查看该报告。这些报告是按生成生成的，并且不包含扩展遥测，除非扩展作者在其根生成目录中添加 telemetry.json 文件。

例如，运行 code --telemetry > telemetry.json && code telemetry.json 将在当前工作目录中创建 telemetry.json 文件，然后在 VS Code 中打开该文件。由于遥测报告的长度，您不能像这样管道输出： code --telemetry | code -。

以下各节详细介绍了用于对遥测进行分类的事件元数据、描述其目的并指示任何特殊处理。

事件分类

classification 字段描述数据类型。

• SystemMetaData - 由 VS Code 生成且非个人可识别的值。
• CallstackOrException - 由程序执行中的失败引起的错误。这些包含已清除用户路径的堆栈跟踪。
• PublicNonPersonalData - 用户生成的、可公开获得的数据，例如，已发布的扩展 ID。
• EndUserPseudonymizedInformation - 用于标识唯一用户但无法识别该用户身份的哈希。例如，哈希的 Mac 地址。

事件目的

purpose 字段描述收集数据的原因。

• PerformanceAndHealth - 确保 VS Code 产品和服务健康且快速。
• FeatureInsight - 了解功能使用情况以及在哪里继续开发投资。
• BusinessInsight - 制定与 VS Code、Microsoft 和 GitHub 业务相关的决策。

事件终结点

endpoint 字段描述将数据发送到的数据处理程序。这通常应用于需要额外清理和安全保护以保护用户隐私的特殊数据。

• GoogleAnalyticsId - 在我们的网站上用于 Google Analytics 和跟踪页面浏览量。这些数据以比我们正常数据更敏感的方式处理。
• MacAddressHash - 用于标识 VS Code 用户。它在客户端上哈希一次，然后在管道端再次哈希，使其不可能识别给定用户。在VS Code for the Web 上，为此情况生成 UUID。
• none - 数据不需要任何特殊处理。

GDPR 和 VS Code

除了支持《通用数据保护条例》(GDPR) 外，VS Code 团队还非常重视隐私。这既是为了微软公司，也是为了 VS Code 团队内部。

为了确保符合 GDPR，我们对 VS Code 进行了多项更新，其中包括

• 通过在产品中为所有现有用户和新用户放置通知，使退出遥测收集更容易。
• 审查并分类我们发送的遥测（记录在 我们的 OSS 代码库 中）。
• 确保我们为收集的任何数据（例如崩溃转储）制定有效的数据保留策略。

简而言之，我们一直努力为所有用户做正确的事情，因为这些实践适用于所有地区，而不仅仅是欧洲。

我们预计人们会问的一个问题是查看我们收集的数据。然而，我们没有可靠的方法来实现这一点，因为 VS Code 没有可以唯一标识用户的“登录”体验。我们确实会发送一些信息来帮助我们为诊断目的估算单个用户（这是基于桌面上的网络适配器 NIC 的哈希值和 Web 上随机分配的 UUID），但这不能保证是唯一的。例如，虚拟机 (VM) 通常会轮换 NIC ID 或从池中分配。此技术足以帮助我们解决问题，但它不足以让我们“提供您的数据”。

随着我们对 GDPR 和用户期望的了解加深，我们希望我们的方法会不断发展。我们非常感谢用户发送给我们的数据，因为它非常有价值，并且 VS Code 因此成为一款对每个人都更好的产品。同样，如果您担心隐私，我们提供了禁用遥测发送的功能，如 禁用遥测报告 中所述。

您可以在 Visual Studio 系列数据主体 GDPR 请求 中找到有关 Visual Studio 系列如何处理 GDPR 的更多信息。

管理在线服务

除了崩溃报告和遥测之外，VS Code 还将在线服务用于各种其他目的，例如下载产品更新、查找、安装和更新扩展、设置同步，或在设置编辑器中提供自然语言搜索。您可以选择打开/关闭使用这些服务的功能。

请注意，关闭这些功能不会使 VS Code 进入离线模式。例如，如果您在 扩展 视图中搜索扩展，VS Code 仍然会搜索在线 VS Code 市场。这些设置确保 VS Code 不会在您请求的情况下与在线服务通信。

从 文件 > 首选项 > 设置，输入标记 @tag:usesOnlineServices。这将显示所有控制在线服务使用的设置，您可以单独打开或关闭它们。

注意：VS Code 扩展程序也可能使用在线服务，并且可能不提供配置这些在线服务使用的设置，或者它们可能不会注册其设置以在搜索 @tag:usesOnlineServices 时显示。请参阅特定扩展的文档以了解其在线服务的使用情况。

VS Code 使用的非 Microsoft 在线服务

内置的 VS Code 的 npm 支持 扩展程序向 https://registry.npmjs.org 和 https://registry.bower.io 发送请求。

内置的 TypeScript 和 JavaScript 语言功能 扩展程序在 https://registry.npmjs.org 查询 @types 域。

当您使用 开发人员：切换开发人员工具 或 开发人员：打开 Webview 开发人员工具 时，VS Code 可能会与 Google 服务器通信，以获取启动开发人员工具所需的数据。

扩展建议

VS Code 根据您的文件类型、您的工作区和您的环境提供扩展建议。文件类型建议可以是预先计算的，也可以是动态的。工作区和环境建议始终是预先计算的。

如果您想知道为什么推荐某个扩展，请打开该扩展的详细信息页面。您可以在页面标题中找到推荐原因。

预先计算的建议

VS Code 会收集有关哪些扩展程序针对哪些文件类型以及哪些工作区/文件夹被激活的遥测数据。特定的文件夹通过计算每个文件夹的 Git 远程的哈希值来识别。

我们使用此信息来预先计算匿名建议。预先计算的建议是指在哪些条件下应推荐扩展的说明。例如，当我们看到两个扩展 A 和 B 之间存在有趣的关联时，一个指令可能是：如果用户已安装扩展 A 但未安装 B，则推荐扩展 B。

一些预先计算的建议作为产品的一部分发布，而其他预先计算的建议则在运行时从 Microsoft 在线服务获取。VS Code 独立评估和执行预先计算的建议，而不会向任何在线服务发送任何用户信息。

动态建议

当您打开 VS Code 没有预先计算建议的文件类型时，它会向扩展市场询问声明支持此文件类型的扩展。如果查询返回您未安装的扩展，VS Code 将提供通知。

对于扩展作者

请阅读 扩展指南遥测文档。

后续步骤

• Visual Studio Code 常见问题 - 请查阅常见问题以了解更多信息。
• 用户和工作区设置 - 阅读有关自定义 VS Code 的可用选项。
• 按键绑定 - 您可以轻松修改常用的键盘快捷键。