参加你附近的 ,了解 VS Code 中的 AI 辅助开发。

遥测

Visual Studio Code 会收集遥测数据,这些数据用于帮助了解如何改进产品。例如,这些使用数据有助于调试问题(如启动时间慢)并优先处理新功能。虽然我们很感激这些数据提供的见解,但我们也知道并非所有人都希望发送使用数据,您可以按照禁用遥测报告中的说明禁用遥测。您还可以阅读我们的隐私声明以了解更多信息。

遥测数据类型

VS Code 和此页面涉及与遥测相关的三种不同类型的数据。

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

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

使用数据 - 使用数据收集有关 VS Code 中功能使用和性能的信息,这有助于我们优先改进未来的产品。

禁用遥测报告

通过telemetry.telemetryLevel用户设置,您可以通过一个设置控制我们发送的不同类型的遥测数据。以下是telemetry.telemetryLevel每个值发送的不同类型数据表

崩溃报告 错误遥测 使用数据
所有
error -
崩溃 - -
off - - -

例如,如果您不想向 Microsoft 发送任何遥测数据,可以将telemetry.telemetryLevel用户设置off。这将停止 VS Code 中所有遥测事件的发送。请注意,在您禁用设置之前,遥测信息可能已被收集和发送。

disable telemetry

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

"telemetry.telemetryLevel": "off"

扩展和遥测

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

扩展作者可以参阅“适用于扩展作者”部分,以获取在其扩展中实施遥测最佳实践的指导。

遥测事件的输出通道

要在 VS Code 中查看发送的遥测事件,请从命令面板 () 运行开发人员:显示遥测命令。此命令启用遥测事件跟踪,并在输出面板 (⇧⌘U (Windows Ctrl+Shift+U, Linux Ctrl+K Ctrl+H)) 中打开遥测输出通道。当遥测事件发送时,输出通道会显示事件详细信息。

output panel log telemetry

当跟踪遥测事件时,事件也会记录到本地文件telemetry.log中,您可以使用开发人员:打开日志...命令并从下拉菜单中选择遥测来查看。

open telemetry log file

要禁用遥测事件跟踪,请重新加载 VS Code 窗口(开发人员:重新加载窗口命令)。

查看所有遥测事件

如果您想查看 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 用户。这在客户端哈希一次,然后在管道侧再次哈希,以使其无法识别给定用户。在Web 版 VS Code上,为此情况生成一个 UUID。
  • none - 数据不需要任何特殊处理。

GDPR 和 VS Code

除了支持通用数据保护条例 (GDPR) 之外,VS Code 团队非常重视隐私。这既包括 Microsoft 公司层面,也包括 VS Code 团队内部。

为确保符合 GDPR,我们对 VS Code 进行了一些更新,其中包括:

  • 通过在产品中为所有现有和新用户提供通知,使选择退出遥测收集变得更容易。
  • 审查和分类我们发送的遥测数据(记录在我们的开源代码库中)。
  • 确保我们对收集的任何数据(例如崩溃转储)都有有效的保留策略。

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

我们预计人们会问的一个问题是查看我们收集的数据。但是,我们没有可靠的方法来做到这一点,因为 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 Marketplace。这些设置可确保 VS Code 不会在您未请求的情况下与在线服务通信。

文件 > 首选项 > 设置中,键入标签@tag:usesOnlineServices。这将显示所有控制在线服务使用的设置,您可以单独将其打开或关闭。

online settings filter

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

VS Code 使用的非 Microsoft 在线服务

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

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

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

扩展建议

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

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

extension recommendation based on files

预先计算的建议

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

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

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

动态建议

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

致扩展作者

请阅读扩展指南遥测文档

后续步骤

© . This site is unofficial and not affiliated with Microsoft.