Visual Studio Code 常见问题

我们的文档包含一个常见问题部分，针对特定主题需要时使用。我们在此处记录了一些不符合其他主题的项目。

如果你在这里没有找到你问题的答案，请查看我们之前 在GitHub上报告的问题 和我们的 版本说明。

在 VS Code 中开源 AI

我们已将 GitHub Copilot Chat 扩展以 MIT 许可证开源，并将其相关组件引入 VS Code 核心。请在我们的 公告博客文章 和 第一个里程碑更新 中阅读所有详细信息。

这会影响我当前的 GitHub Copilot 订阅吗？现在 GitHub Copilot 是免费的吗？

此更改不会影响当前的 GitHub Copilot 订阅。要使用 GitHub Copilot，您将继续需要一个 GitHub 帐户，并且需要访问 GitHub Copilot 订阅。

没有通过组织或企业获得Copilot的个人开发者可以使用GitHub Copilot免费计划（可能有限制）。如果该计划不能满足您的需求，您可以注册一个付费的Copilot计划或使用自己的模型密钥。

GitHub Copilot的后端服务也会开源吗？

GitHub Copilot 服务不受影响，将继续保持闭源。

时间表是什么？我什么时候可以为 VS Code 的 AI 体验做出贡献？

我们已经完成了这一过程的第一步，通过将GitHub Copilot Chat扩展开源。源代码可以在microsoft/vscode-copilot-chat仓库中找到。

在未来几个月内，我们将把Copilot Chat扩展的相关组件合并到核心VS Code仓库中。请查看我们的计划项目以获取详细信息和时间线更新。

我们的目标是使为我们的AI功能贡献变得和为VS Code的任何部分贡献一样简单。为此，我们希望在贡献时能够使用Copilot后端服务进行调试和测试。 请查看CONTRIBUTING.md文件以了解如何贡献的详细信息。

为什么将 GitHub Copilot 集成到核心 VS Code 仓库中？

自 GitHub Copilot 首次发布以来，很明显，AI 助力的工具是我们编写代码的核心。从使用遥测数据中，我们可以看到，实际上有更多用户在 VS Code 中使用 AI 功能，而不是像调试或测试这样的其他功能。

将 AI 功能作为 VS Code 的核心部分，是我们重申的一个信念，即公开工作对我们的用户来说会带来更好的产品，并促进多样化的扩展生态系统。

我是一个扩展作者。我会受到影响吗？

我们为稳定的应用程序编程接口（API）维护向后兼容性。您不应期望这对您的扩展有任何影响。 我们根据扩展作者的反馈，不断改进和扩展 VS Code 扩展 API。如果您需要额外的 API 来使您的扩展成功，请告诉我们 – 请在 microsoft/vscode 仓库 提出 API 请求。

我已经在 VS Code 中使用了其他 AI 编码扩展（Cline, Roo Code, ...）。这对我有什么影响？

你可以在 VS Code 中继续使用这些扩展！ 我们很高兴社区正在开发扩展，以提升 VS Code 中的开发者体验。 为了改善其他 AI 扩展的体验，我们不断添加 API，例如 语言模型 API，用于从扩展直接调用语言模型，工具 API，用于与语言模型工具互动并集成到内置或你自己的代理中，或者 shell 执行 API，用于运行和与终端命令互动（特别适用于代理体验）。未来，我们计划添加更多 API，以满足扩展作者的需求。

这会改变你收集数据的方式吗？

不，什么都不会改变。通过将GitHub Copilot Chat开源，我们使数据收集过程完全透明，并允许您在源代码中进行验证。了解更多关于VS Code中的遥测和GitHub Copilot信任中心的信息。

VS Code团队在未来版本中将如何平衡AI功能和非AI功能的优先级？

我们相信，由AI驱动的工具是我们编写代码的核心。我们投资于AI功能和改进核心编辑器体验。这在团队的工作分配上也有所体现，50%的团队致力于AI，50%的团队致力于其他功能。 许多非AI功能可能并不总是对用户那么显眼，例如性能、安全性、可访问性、Electron更新等。

将AI功能引入核心VS Code仓库是否会影响VS Code的性能（启动性能）？

性能是我们的核心优先事项，我们致力于在整合AI功能时保持VS Code的性能。此外，如果您不启用VS Code中的AI功能，将不会运行任何可能影响性能的关联后台进程。

我可以在 VS Code 中禁用 AI 功能吗？

你可以通过以下方式禁用 VS Code 中的内置 AI 功能

或者，使用学习如何隐藏AI功能操作，从标题栏中的聊天菜单访问设置。

如果我在 VS Code 中禁用 AI 功能，我的数据是否仍然会被发送到微软？

不，如果你在 VS Code 中禁用 AI 功能，或者你没有从 VS Code 登录你的 Copilot 订阅，你的数据不会被发送到 Copilot 后端服务。了解更多关于 VS Code 的遥测 和 GitHub Copilot 信任中心 的信息。

VS Code 在 Copilot 扩展中使用的模型是开源 (OSS) 的吗？

不。GitHub Copilot使用的模型是单独授权的，这并没有改变。事实上，大多数这些模型都是来自第三方，例如OpenAI、Anthropic和Google...

Visual Studio Code 和 Visual Studio IDE 有什么区别？

Visual Studio Code 是一个精简的代码编辑器，支持调试、任务运行和版本控制等开发操作。它的目标是为开发者提供一个快速的代码-构建-调试循环所需工具，并将更复杂的流程交给功能更完整的 IDE，例如 Visual Studio IDE.

VS Code 是免费的吗？

是的，VS Code 对个人或商业使用都是免费的。详情请参阅产品许可。

如果你还没有 Copilot 订阅，你可以通过注册 Copilot 免费计划 来免费使用 Copilot，并获得每月的内置建议和聊天互动的限制。

平台支持

哪些操作系统是支持的？

VS Code 可运行于 macOS、Linux 和 Windows。请参阅要求文档了解支持的版本。您可以在设置概述中找到更多特定于平台的详细信息。

我可以在旧版本的Windows上运行VS Code吗？

Microsoft 已经停止支持并不会再为 Windows 7、Windows 8 和 Windows 8.1 提供安全更新。VS Code 桌面版本从 1.71（2022 年 8 月）开始不再支持 Windows 7，从 1.80（2023 年 6 月）开始不再支持 Windows 8 和 8.1。您需要升级到更新的 Windows 版本才能使用 VS Code 的后续版本。

VS Code 将不再为旧的 Windows 版本提供产品更新或安全修复。VS Code 版本 1.70.3 是 Windows 7 用户的最后一版本，版本 1.79 将是 Windows 8 和 8.1 用户的最后一版本。您可以在 support.microsoft.com 了解更多关于升级 Windows 版本的信息。

此外，Windows 10 版本 2004 已经不再支持 32 位 OEM。最后一个支持 Windows 32 位的稳定版 VS Code 是 1.83（2023 年 9 月）。您需要更新到 64 位版本。

我可以在旧版本的 macOS 上运行 VS Code 吗？

VS Code桌面版本从1.105（2025年9月）开始将停止对macOS Big Sur（版本11.0及更早版本）的支持。从VS Code 1.107（2025年11月）开始，我们将停止对macOS Big Sur（版本11.0及更早版本）上的VS Code进行更新。您需要升级到更新的macOS版本才能使用VS Code的更高版本。

VS Code 将不再为 macOS Big Sur (版本 11.0 及更早) 提供产品更新或安全修复，VS Code 版本 1.106 将是 macOS Big Sur (11.0 及更早) 可用的最后一个版本。您可以在 support.apple.com 了解更多关于升级您的 macOS 版本的信息。

我可以在较旧的 Linux 发行版上运行 VS Code 吗？

从 VS Code 1.86.1 版本（2024年1月）开始，VS Code 桌面版仅与基于 glibc 2.28 或更高版本的 Linux 发行版兼容，例如 Debian 10、RHEL 8 或 Ubuntu 20.04。

如果您无法升级您的 Linux 发行版，推荐的替代方案是使用我们的网页客户端。如果您想使用桌面版本，可以从这里下载 VS Code 1.85 版本。根据您的平台，确保禁用更新以保持该版本。一个很好的建议是使用便携模式进行安装。

我可以运行VS Code的便携版吗？

是的，VS Code 有一个便携模式，可以让你将设置和数据保存在与安装相同的位置，例如在 USB 驱动器上。

遥测和崩溃报告

如何禁用遥测报告

VS Code 收集使用数据并将其发送给微软，以帮助改进我们的产品和服务。阅读我们的隐私声明和遥测文档以了解更多信息。

如果您不想向微软发送使用数据，您可以设置遥测.遥测级别 用户 设置 为 关输入：.

从 文件 > 首选项 > 设置，搜索 遥测，并设置遥测：遥测级别 选项为关这将从 VS Code 以后的所有遥测事件静音。

重要通知：VS Code 给您提供安装 Microsoft 和第三方扩展的选择。这些扩展可能会收集其自身的使用数据，并且不受 遥测.遥测级别设置。查阅特定扩展的文档以了解其遥测报告。

如何禁用实验

VS Code 使用实验来尝试新功能或逐步推出它们。我们的实验框架调用一个微软拥有的服务，因此在启用遥测时会被禁用。然而，如果您希望无论您的遥测偏好如何都禁用实验，您可以设置工作台启用实验 用户 设置 为 假输入：.

从 文件 > 首选项 > 设置，搜索 实验，取消勾选Workbench: 启用实验设置。这将防止 VS Code 调用服务，并退出任何正在进行的实验。

如何禁用崩溃报告

VS Code 收集有关任何崩溃的数据，并将其发送给 Microsoft，以帮助改进我们的产品和服务。阅读我们的隐私声明和遥测文档以了解更多信息。

如果您不想向微软发送崩溃数据，您可以更改遥测.遥测级别 用户 设置 为 关输入：.

从 文件 > 首选项 > 设置，搜索 遥测，并设置遥测：遥测级别 选项为关这将静默所有遥测事件，包括 VS Code 的崩溃报告。您需要重启 VS Code 以使更改生效。

GDPR 和 VS Code

既然《通用数据保护条例》（GDPR）已经生效，我们想借此机会重申，我们非常重视隐私。这不仅适用于微软公司，也适用于VS Code团队内部。

为了支持GDPR：

• VS Code 产品通知所有用户，他们可以选择退出遥测数据收集。
• 团队积极地审查和分类所有发送的遥测数据（详见我们的开源代码库）。
• 对于收集到的任何数据，都有有效的数据保留政策，例如崩溃转储。

您可以在遥测文档中了解更多关于 VS Code 符合 GDPR 的信息。

VS Code 使用哪些在线服务？

除了崩溃报告和遥测，VS Code 还使用在线服务用于其他各种目的，例如下载产品更新、查找、安装和更新扩展，或在设置编辑器中提供自然语言搜索。您可以在 管理在线服务 中了解更多信息。

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

许可

位置

您可以在您的 VS Code 安装位置找到 VS Code 许可证、第三方声明和Chromium开源来源列表资源\应用程序文件夹。VS Code 的第三方通知.txt, Chromium的致谢_*.html，以及 VS Code 的英语语言许可证.txt在以下条件下可用资源\应用程序. 本地化版本的许可证.txt按语言ID分类的在以下资源\应用程序\许可证输入：.

为什么 Visual Studio Code 的许可证与 vscode GitHub 仓库不同？

要了解Visual Studio Code产品与开源vscode GitHub仓库的许可证为何不同，请参阅问题 #60以获取详细解释。

有什么区别Visual Studio Code仓库和 Microsoft Visual Studio Code 发行版？

该github.com/microsoft/vscode仓库 (代码 - 开源软件) 是我们开发 Visual Studio Code 产品的地方。我们不仅在那里编写代码和解决问题，还发布我们的路线图和每月的迭代和最终计划。源代码在标准 MIT 许可证下对所有人开放。

Visual Studio Code 是一个分发版的代码 - 开源软件 包含微软特定定制的代码库（包括源代码），根据传统 微软产品许可协议发布。

请参阅Visual Studio Code 和 'Code - OSS' 的区别文章了解更多信息。

“基于开源”是什么意思？

Microsoft Visual Studio Code 是 微软授权的发行版 ‘Code - OSS’，包含了微软专有的资产（如图标）和功能（如Visual Studio Marketplace集成，实现远程开发的某些方面）。虽然这些添加只占整体发行代码库的一小部分，但由于这些差异，说Visual Studio Code是“基于”开源，而不是“是”开源更为准确。有关每个发行版包含内容的更多信息，请参阅 Visual Studio Code和‘Code - OSS’的差异文章。

扩展

所有的 VS Code 扩展都是开源的吗？

扩展作者可以自由选择符合其业务需求的许可证。虽然许多扩展作者选择在开源许可证下发布其源代码，但某些扩展如Wallaby.js、Google Cloud Code和VS Code 远程开发扩展使用专有许可证。

在微软，我们有混合的开源和闭源扩展。依赖现有的专有源代码或库，源代码跨入微软授权的工具或服务（例如，C# DevKit 扩展使用 Visual Studio 订阅许可模型，见许可），以及微软整体业务模式的差异，可能导致扩展选择专有许可。您可以在微软扩展许可文章中找到微软贡献的 Visual Studio Code 扩展及其源代码许可证的列表。

如何找到扩展的许可证？

大多数扩展将在市场页面（他们的“读我”文件）上提供其许可证链接，可以在资源右侧栏找到。如果找不到链接，如果扩展的仓库是公开的，你可以在扩展的仓库中找到许可证，或者你可以通过市场的问答部分联系扩展的作者。

我可以在 VS Code 之外使用 Microsoft 扩展吗？

不。尽管来自微软的扩展的源代码可能是开源的，但我们不许可在Visual Studio Marketplace上发布并从那里获取的微软或其附属公司发布的扩展，以在Visual Studio家族产品之外使用：Microsoft Visual Studio、Visual Studio Code、GitHub Codespaces、Azure DevOps、Azure DevOps Server以及我们和微软附属公司提供的后续产品和服务，例如GitHub，Inc. 我们仅在Visual Studio家族产品中构建、测试、部署和支持这些扩展和服务，以确保它们符合我们的安全和质量标准。我们不这样做扩展的其他地方，包括基于Code - OSS存储库的扩展。请参阅条件：市场/NuGet产品的使用权利 在 Visual Studio 市场 服务条款 了解更多信息。

我无法从产品 << 填空 >> 访问 Visual Studio 市场，为什么呢？

我们为Visual Studio家族产品：Microsoft Visual Studio, Visual Studio Code, GitHub Codespaces, Azure DevOps, Azure DevOps Server，以及我们和微软附属公司（如GitHub, Inc.）提供的后续产品和服务，提供Visual Studio市场。因此，包括基于Code - OSS仓库的衍生产品，不允许访问Visual Studio市场。我们这样做是为了保护生态系统的安全性和质量，包括以下措施：

• 扩展在产品的上下文中运行，并具有产品的权限，它们可能包含可执行代码。 市场对每个扩展进行安全检查，并防止其执行恶意活动。当您在 Visual Studio 家族中安装产品的一个扩展时，您可以确信它已经过检查，可以在该上下文中运行。

• 当恶意扩展被举报并验证，或在扩展依赖中发现漏洞时，该扩展将从市场中移除，添加到黑名单中，并由 VS Code 自动卸载。

• 微软投入了大量资源来运营、维护和保障这一全球在线服务。Visual Studio 家族中的产品旨在以安全可靠的方式访问市场，因此在您需要时，市场可以正常使用。

• 扩展可能会与产品深度集成。市场确保我们保持API兼容性，并且扩展正确使用产品的扩展API。这有助于确保您安装的扩展在版本更新中能够正常工作。

参见#31168了解此主题的更多详细信息。

我为什么要从Visual Studio Marketplace安装扩展？

从Visual Studio Marketplace安装扩展有许多优点，而不是从其他来源安装。

• Visual Studio 市场使用多种机制来保护您不安装恶意扩展，包括恶意软件扫描、动态检测、发布者验证等。当您从其他来源安装扩展时，无法保证该扩展在您的上下文中运行是安全的。

• 当恶意扩展被报告并验证，或在扩展依赖中发现漏洞时，该扩展将从市场中移除，添加到黑名单，并由 VS Code 自动卸载。

• 市场使您能够轻松找到、安装和更新扩展。例如，如果有安全修复更新，VS Code 会自动安装更新版本。

• 扩展可能会与产品深度集成。市场确保我们保持API兼容性，并且扩展正确使用产品的扩展API。这有助于确保您安装的扩展在版本更新中能够正常工作。

报告 VS Code 扩展的问题

对于错误、功能请求或联系扩展作者，您应该使用 Visual Studio Code 市场 中的链接，或者使用 帮助：报告问题 从命令面板。然而，如果问题是扩展不遵守我们的行为准则，例如包含粗俗语言、色情内容或对用户构成风险，则我们有 一个电子邮件别名来报告问题。一旦收到邮件，我们的市场团队将研究适当的行动方案，包括但不限于取消发布扩展。

VS Code 版本

如何找到我当前的 VS Code 版本？

你可以在关于对话框中找到 VS Code 版本信息。

在 macOS 上，转到 Code > 关于 Visual Studio Code。

在 Windows 和 Linux 上，前往 帮助 > 关于。

VS Code 版本号是第一个版本号，格式为 '主要.次要.修订'，例如 '1.100.0'。

之前的发布版本

您可以在版本发布说明的顶部找到一些发布下载链接：

如果您需要那里没有列出的安装类型，您可以手动下载以下URL：

在其中输入您想要的具体版本{版本}占位符。例如，要下载1.83.1的Linux Arm64 debian版本，你会使用

https://update.code.visualstudio.com/1.83.1/linux-deb-arm64/stable

您可以使用版本字符串最新，如果你希望总是下载最新的 VS Code 稳定版。

Windows 32位版本

Windows x86 32-bit 版本在发布 1.83 后将不再被积极支持，并且可能带来安全风险。

预发布版本

想提前体验新的 VS Code 功能吗？你可以通过安装 "Insiders" 版本来试用 VS Code 的预发布版本。Insiders 版本会与你稳定的 VS Code 安装并行安装，并且有隔离的设置、配置和扩展。Insiders 版本每天晚上更新，所以你会获得前一天的最新错误修复和功能更新。

要安装Insiders版本，请访问Insiders下载页面。

如何选择退出 VS Code 自动更新？

默认情况下，VS Code 为 macOS 和 Windows 用户在我们发布新更新时自动更新。如果您不想自动更新，可以设置更新：模式 选项默认至无输入：.

要修改更新模式，请转到文件 > 首选项 > 设置，搜索更新模式并更改设置为无输入：.

如果你使用JSON编辑器来设置，添加以下行：

    "更新模式"："无"

您可以通过卸载当前版本，然后安装在特定发行说明页面顶部提供的下载来安装 VS Code 的以前版本。

注意： 在 Linux 上：如果 VS Code 仓库安装正确，则您的系统包管理器应像系统上的其他软件包一样处理自动更新。请参阅 在 Linux 上安装 VS Code。

选择不接收扩展更新

默认情况下，VS Code 会自动更新扩展，当有新版本可用时。如果您不希望扩展自动更新，可以在设置编辑器中清除扩展：自动更新复选框（⌘,（Windows, Linux Ctrl+,））。

如果你使用JSON编辑器修改你的设置，请添加以下行：

    "extensions.autoUpdate"： false

我在哪里可以找到Visual Studio Code的图标？

使用图标和名称是否有指导方针？

您可以下载官方的Visual Studio Code图标，并阅读使用指南 图标和名称使用指南.

什么是 VS Code "工作区"?

VS Code 的“工作区”通常只是你的项目根文件夹。VS Code 使用“工作区”概念来限制项目配置，例如项目特定的设置 以及用于调试和任务的配置文件。工作区文件存储在项目根目录中的一个.vscode 文件夹。通过一个名为 多根工作区 的功能，你可以在 VS Code 工作区中拥有多个根文件夹。

您可以在 VS Code "工作区" 介绍文章 中了解更多信息。

问题和事项

安装程序似乎已损坏 [不支持]

VS Code 在后台检查以检测安装是否已在磁盘上更改，如果是，则您将在标题栏中看到文本[不支持]。这是由于某些扩展直接修改（修补）VS Code产品，这种方式是半永久的（直到下次更新），这可能会导致难以重现的问题。我们不是要阻止VS Code修补，但我们要提高意识，修补VS Code意味着您在运行不受支持的版本。重新安装VS Code将替换被修改的文件并消除警告。

您还可能会看到[不支持]消息，如果VS Code文件被反病毒软件错误地隔离或删除（请参见问题#94858的示例）。检查您的反病毒软件设置并重新安装VS Code以修复丢失的文件。

解析 shell 环境失败

当 VS Code 从终端启动时（例如，通过代码)，它有访问您环境设置的权限.bashrc或.zshrc文件。这意味着任务或调试目标等特性也可以访问这些设置。

然而，当从你的平台用户界面启动（例如，在macOS dock中的VS Code图标）时，你通常不是在 shell 上下文中运行，并且无法访问这些环境设置。这意味着，根据你如何启动 VS Code，你可能不会拥有相同的环境。

为了解决这个问题，当通过用户界面手势启动时，VS Code 会启动一个小型进程来运行（或“解析”）您在中定义的 shell 环境。.bashrc，.zshrc，或 PowerShell 配置文件。如果在可配置的超时时间（通过application.shellEnvironmentResolutionTimeout默认为10秒），如果 shell 环境仍然未被解析或解析失败，或者由于其他原因导致解析失败，VS Code 将中止“解析”进程，启动时不会加载你的 shell 环境设置，并且你会看到如下错误：

如果错误信息表明解析您的 shell 环境花费了太长时间，以下步骤 可以帮助您调查可能导致延迟的原因。您还可以通过配置来增加超时时间 application.shellEnvironmentResolutionTimeout设置。但请记住，增加这个值意味着您将需要更长时间才能在 VS Code 中使用某些功能，例如扩展。

如果您看到其他错误，请创建一个问题以获得帮助。

调查慢速的 shell 启动

下面的过程可能会帮助你确定你的 shell 初始化中哪些部分花费了最多的时间：

• 打开你的 shell 的启动文件（例如，在 VS Code 中通过输入~/.bashrc或~/.zshrc 在快速打开中 (⌘P (Windows, Linux Ctrl+P))).
• 选择性地注释掉可能会长时间运行的操作（例如没关系如果你发现那个。
• 保存并完全重启 VS Code。
• 继续注释操作，直到错误消失。

注意：当没关系 是一个功能强大且有用的 Node.js 包管理器，但如果在 shell 初始化期间运行，可能会导致 shell 启动时间变慢。您可以考虑使用其他包管理器，例如 asdf 或在互联网上搜索 没关系性能建议。

从终端启动 VS Code

如果修改你的 shell 环境不切实际，你可以通过直接从完全初始化的终端启动 VS Code 来避免 VS Code 解析 shell 环境的阶段。

• 打字代码从一个打开的终端将启动 VS Code 并加载你上次使用的工程环境。
• 打字代码将启动 VS Code 并打开到当前文件夹。

VS Code 是空白的？

Visual Studio Code 使用的 Electron 层在某些 GPU（图形处理单元）硬件加速上存在麻烦。如果 VS Code 显示的主Windows是空白的（空的），您可以通过在启动 VS Code 时添加 Electron 来尝试禁用 GPU 加速--禁用GPU命令行开关。

代码 --禁用GPU

如果在更新后发生，删除通用缓存目录可以解决此问题。

删除 -r ~/.config/Code/GPUCache

VS Code 在打开文件夹后立即无响应

当你打开一个文件夹时，VS Code 会搜索典型的项目文件，以向你提供额外的工具（例如状态栏上的解决方案选择器，用于打开解决方案）。如果你打开一个包含大量文件的文件夹，搜索可能会消耗大量时间和 CPU 资源，在此期间 VS Code 可能会响应缓慢。我们计划在未来改进这一点，但目前你可以通过 排除探索器中的文件夹。文件排除设置并且它们将不会被搜索用于项目文件：

    "files.exclude": {
        "**/largeFolder": true
    }

技术支持渠道

您可以在Stack Overflow上提问并搜索答案，还可以直接在我们的GitHub 仓库中提交问题和功能请求。

如果您想联系专业支持工程师，您可以向Microsoft协助支持团队提交工单。