在 Windows 上安装 Visual Studio Code
Visual Studio Code 在 Windows 上提供用户安装程序、系统安装程序和 ZIP 压缩包几种安装方式。对于大多数人来说，推荐使用用户安装程序，因为它不需要管理员权限，并支持更平稳的后台更新。
在 Windows 上安装 VS Code
选择用户安装程序还是系统安装程序
VS Code 同时提供 Windows 用户级和系统级的安装程序。
| 安装类型 | 适用情况 | 注意事项 |
|---|---|---|
| 用户安装 | 为你的 Windows 账户安装 VS Code。 | 此安装不需要管理员权限。它会安装在 %LOCALAPPDATA%\Programs\Microsoft VS Code 目录下，并提供最顺畅的更新体验。当通过用户安装的 VS Code 以管理员身份运行时，更新功能会被禁用。 |
| 系统安装 | 为机器上的所有用户安装 VS Code。 | 此安装需要管理员权限，并安装在 Program Files 目录下。产品内更新也需要提升权限。 |
请参阅下载 Visual Studio Code页面以获取完整的安装选项列表。
使用 Windows 安装程序安装
-
下载适用于 Windows 的 Visual Studio Code 用户安装程序。
-
运行安装程序
VSCodeUserSetup-{version}.exe。默认情况下，用户安装程序将 VS Code 安装在
C:\Users\{Username}\AppData\Local\Programs\Microsoft VS Code下。
安装程序会将 Visual Studio Code 添加到你的 %PATH% 环境变量中。安装完成后重启控制台，然后在某个文件夹中运行 code . 即可在该文件夹中打开 VS Code。
使用系统安装程序安装
-
下载适用于 Windows 的 Visual Studio Code 系统安装程序。
-
以管理员权限运行安装程序。
系统安装使机器上的所有用户都可以使用 VS Code。
从 ZIP 压缩包安装
-
下载适用于 Windows 的 Visual Studio Code ZIP 压缩包。
-
解压 ZIP 压缩包，并从解压后的文件夹中运行 VS Code。
当从 ZIP 压缩包安装 VS Code 时，需要为每个新版本手动更新。
更新说明
VS Code 每周发布更新，并在有新版本可用时支持自动更新。当 VS Code 提示你进行更新时，接受提示以安装新版本。
如果你倾向于按照自己的时间表更新 VS Code，可以禁用自动更新。
在 Windows 上进行开发
Windows 作为跨平台开发环境表现出色。本节涵盖 Windows Subsystem for Linux (WSL) 和 Windows 终端 (Windows Terminal)。
保持 Windows 为最新状态。检查 设置 > Windows 更新 以获取可用更新。
Windows Subsystem for Linux
通过 WSL，你可以在 Windows 上安装并运行 Linux 发行版，以便在 Linux 上开发和测试源代码，同时在本地 Windows 机器上工作。
配合 WSL 扩展使用时，VS Code 能够在 WSL 的上下文中运行，并提供编辑和调试支持。
请参阅在 WSL 中开发文档以了解更多信息，或者尝试在 WSL 中工作入门教程。
Windows 终端
可从微软商店获取的 Windows 终端 (Windows Terminal) 是一款适用于命令行工具和 Shell（如命令提示符、PowerShell 和 WSL）的终端应用程序。其主要功能包括多标签页、窗格、Unicode 和 UTF-8 字符支持、GPU 加速的文本渲染引擎、自定义主题、样式和配置。
安装之后
安装 VS Code 后，完成开发工作流的设置
- 安装附加组件，包括 Git、Node.js、TypeScript、语言运行时和命令行工具。
- 从 Visual Studio Marketplace 安装扩展以添加主题、格式化程序、调试器和语言支持。
- 设置 GitHub Copilot 以在 VS Code 中使用 AI 功能。
- 启动 VS Code 教程，对用户界面和关键功能进行实践探索。
常见问题
Windows 安装程序支持哪些命令行参数？
VS Code 使用 Inno Setup 创建其 Windows 安装包。所有 Inno Setup 命令行开关均可用。
要防止安装完成后启动 VS Code，请使用 /mergetasks=!runcode。
安装程序遇到问题
请使用 ZIP 压缩包代替安装程序。要使用此安装方法，请将 VS Code 解压到你的 AppData\Local\Programs 文件夹中。
启用 AppLocker 时无法以管理员身份运行
随着进程沙盒机制的引入，由于运行时沙盒的限制，配置了 AppLocker 时目前不支持以管理员身份运行。阅读 VS Code 沙盒博客文章以了解更多信息。
如果你的工作需要从提升权限的终端运行 VS Code
-
在 VS Code 的命令面板中运行 Preferences: Configure Runtime Arguments（首选项: 配置运行时参数）命令（⇧⌘P (Windows, Linux Ctrl+Shift+P)）。
此命令会打开一个
argv.json文件以配置 VS Code 的运行时参数。该文件可能已经包含默认参数。 -
将
"disable-chromium-sandbox": true添加到argv.json文件中。 -
重启 VS Code。随后 VS Code 即可从提升权限的终端中运行。
订阅 issue #122951 以接收更新。
处理 UNC 路径
从 1.78.1 版本开始，Windows 上的 VS Code 仅打开满足以下条件的 UNC 路径：在启动时由用户批准，或者其主机名通过 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 路径时的安全性。有关更多信息，请参阅相关的安全公告。