Windows 上的 Visual Studio Code

安装

1. 下载适用于 Windows 的 Visual Studio Code 安装程序。
2. 下载完成后，运行安装程序 (VSCodeUserSetup-{version}.exe)。这只需要一分钟。
3. 默认情况下，VS Code 安装在 C:\Users\{用户名}\AppData\Local\Programs\Microsoft VS Code 下。

或者，您也可以下载 ZIP 存档，解压缩它并从那里运行 Code。

提示：设置会将 Visual Studio Code 添加到您的 %PATH% 中，因此您可以从控制台输入 'code .' 以在该文件夹中打开 VS Code。您需要在安装后重新启动控制台，才能使对 %PATH% 环境变量的更改生效。

用户设置与系统设置

VS Code 提供 Windows 用户级和系统级设置。

用户设置 不需要管理员权限即可运行，因为其位置将在您的用户 Local AppData (LOCALAPPDATA) 文件夹下。由于不需要提升权限，用户设置能够提供更流畅的后台更新体验。这是在 Windows 上安装 VS Code 的首选方法。

注意：当以管理员身份在用户设置安装中运行 VS Code 时，更新将被禁用。

系统设置 需要提升到管理员权限才能运行，并将安装放置在系统的 Program Files 下。产品内更新流程也需要提升权限，这使得它不如用户设置那么简便。另一方面，使用系统设置安装 VS Code 意味着它将对系统中的所有用户可用。

请参阅 下载 Visual Studio Code 页面，获取可用安装选项的完整列表。

更新

VS Code 每月发布 版本，并在有新版本可用时支持自动更新。如果您收到 VS Code 的提示，请接受最新的更新，它将被安装（您无需执行任何其他操作即可获得最新的版本）。

注意：如果您希望按照自己的时间安排更新 VS Code，可以 禁用自动更新。

Windows Subsystem for Linux

Windows 是一个流行的操作系统，它可以成为一个很棒的跨平台开发环境。本节介绍跨平台功能，例如 Windows Subsystem for Linux (WSL) 和新的 Windows 终端。

最新版本的 Windows 构建

确保您使用的是最新版本的 Windows 10 构建。检查设置 > Windows 更新，查看您的系统是否已更新。

将 Windows 用作开发机器

使用 WSL，您可以在 Windows 上安装和运行 Linux 发行版。这使您能够在 Linux 上开发和测试您的源代码，同时仍在您的 Windows 机器上本地工作。

与 WSL 扩展结合使用，您可以在 WSL 的上下文中运行时，获得完整的 VS Code 编辑和调试支持。

请参阅 在 WSL 中开发 文档，了解详细信息或尝试 在 WSL 中工作 入门教程。

新的 Windows 终端

从 Microsoft Store 获得的 Windows 终端 (预览版) 使您能够轻松地在多标签 shell 中打开 PowerShell、命令提示符和 WSL 终端。

后续步骤

安装 VS Code 后，以下主题将帮助您了解有关 VS Code 的更多信息

• 附加组件 - 了解如何安装 Git、Node.js、TypeScript 和 Yeoman 等工具。
• 用户界面 - VS Code 的快速入门指南。
• 用户/工作区设置 - 了解如何通过设置将 VS Code 配置为满足您的偏好。
• 提示和技巧 - 允许您直接开始学习如何在 VS Code 中提高工作效率。

常见问题

Windows 设置支持哪些命令行参数？

VS Code 使用 Inno Setup 为 Windows 创建其设置包。因此，所有 Inno Setup 命令行开关 都可用于此目的。

此外，您可以使用 /mergetasks=!runcode 阻止设置在完成安装后启动 VS Code。

滚动滞后且不流畅

在某些设备上，编辑器滚动不流畅，而是滞后，导致用户体验不佳。如果您遇到此问题，请确保安装了 Windows 10 2018 年 10 月更新，其中已修复此问题。

安装程序出现问题

尝试使用 ZIP 文件 而不是安装程序。要使用此方法，请将 VS Code 解压缩到您的 AppData\Local\Programs 文件夹中。

注意：当 VS Code 通过 ZIP 文件安装时，您需要手动更新每个 版本。

缺少图标

我在 Windows 8 机器上安装了 Visual Studio Code。为什么工作区和编辑器中不显示某些图标？

VS Code 使用 SVG 图标，我们发现某些情况下 .SVG 文件扩展名与 image/svg+xml 以外的其他内容相关联。我们正在考虑解决此问题的方案，但目前您可以尝试以下解决方法

使用命令提示符

1. 打开管理员命令提示符。
2. 输入 REG ADD HKCR\.svg /f /v "Content Type" /t REG_SZ /d image/svg+xml。

使用注册表编辑器 (regedit)

1. 启动 regedit。
2. 打开 HKEY_CLASSES_ROOT 键。
3. 找到 .svg 键。
4. 将其 Content Type 数据值设置为 image/svg+xml。
5. 退出 regedit。

启用 AppLocker 时无法以管理员身份运行

随着进程沙箱的引入（在本 博客文章 中讨论），由于运行时沙箱的限制，目前在配置了 AppLocker 时不支持以管理员身份运行。如果您需要从提升权限的终端运行 VS Code，您可以使用 `--no-sandbox --disable-gpu-sandbox` 作为解决方法来启动 `code`。

订阅 问题 #122951 以接收更新。

使用 UNC 路径

从版本 `1.78.1` 开始，Windows 上的 VS Code 仅允许访问在启动时用户批准的或通过新的 security.allowedUNCHosts 设置配置为允许的主机名的 UNC 路径（这些路径以 `\\` 开头）。

如果您依赖于在 VS Code 中使用 UNC 路径，您可以：

• 通过 security.allowedUNCHosts 设置配置允许的主机（例如，在打开 `\\server-a\path` 这样的路径时添加 `server-a`）
• 将 UNC 路径映射为网络驱动器，并使用驱动器字母代替 UNC 路径 (文档)
• 定义一个全局环境变量 `NODE_UNC_HOST_ALLOWLIST`，其中包含以反斜杠分隔的主机名列表，例如：`server-a\server-b`，以允许 `server-a` 和 `server-b` 主机。

注意：如果您使用任何远程扩展远程连接到工作区（例如 SSH），则需要在远程计算机而不是本地计算机上配置 security.allowedUNCHosts。

此更改是为了在使用 VS Code 时提高使用 UNC 路径的安全性。有关更多信息，请参阅相关的 安全公告。