默认应选用户版(UserInstaller)安装VS Code,因其装入%LOCALAPPDATA%\Programs\Microsoft VS Code,无需UAC、不改HKLM注册表、不影响其他用户;系统版需管理员权限且易致更新失败或插件异常。

直接装用户版(UserInstaller),别碰系统版(SystemInstaller),除非你明确要给所有账户共用、且有管理员权限长期维护。
为什么默认选用户版安装?
Win10下普通用户日常开发,UserInstaller才是合理默认:它把VS Code装进%LOCALAPPDATA%\Programs\Microsoft VS Code,全程无需UAC弹窗,不改HKEY_LOCAL_MACHINE注册表,不影响其他用户。而系统版强制走C:\Program Files\Microsoft VS Code,每次更新都得点“是”,多人共用电脑时还可能因权限冲突导致插件失效或设置丢失。
常见错误现象:Update failed: EPERM: operation not permitted —— 基本就是误装了系统版,又以非管理员身份运行导致的。
- 安装路径可自定义,但建议保持默认(即用户目录下),避免后续PATH配置错位
- 勾选“Add to PATH”必须打勾,否则终端里敲
code会报“command not found” - “Register as Editor for Supported File Types”和“Add “Open with Code” action”也建议勾上,省得手动右键菜单配置
安装后第一件事:确认 code 命令可用
打开任意终端(CMD/PowerShell/WSL),输入 code --version。如果返回类似 1.89.1 的版本号,说明PATH生效;若提示“不是内部或外部命令”,说明安装时没勾选“Add to PATH”,得手动补:
进入「系统属性 → 高级 → 环境变量」,在「用户变量」的 Path 里新增一行:%LOCALAPPDATA%\Programs\Microsoft VS Code\bin(注意不是安装目录主文件夹,是里面的 bin 子目录)。
别重启终端——关掉再重开,或者执行 refreshenv(需先装 chocolatey)或 $env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")(PowerShell中临时刷新)。
汉化与基础扩展别跳过
启动VS Code后,按 Ctrl+Shift+X 打开扩展面板,搜 Chinese Simplified Language Pack 并安装——这是官方汉化包,不是第三方翻译插件。重启后界面即中文。
紧接着装这三个基础扩展(按项目类型选):
- Python:对应
ms-python.python,装完会自动提示安装 Pylance 和 Jupyter - C/C++:对应
ms-vscode.cpptools,注意它依赖单独的cpptools-srv后台进程,首次打开 .cpp 文件会自动拉取 - Remote - SSH:对应
ms-vscode-remote.remote-ssh,如果你要用WSL或远程Linux开发,这个比“WSL”扩展更底层、更稳定
别装“一键全栈套装”类合集插件——它们常捆绑过期依赖,容易引发 Extension host terminated unexpectedly。
真正麻烦的从来不是安装本身,而是PATH没生效、多用户权限混用、以及汉化包和主题扩展互相覆盖UI渲染层——这三处出问题,比重装十次还耗时间。


















