绝大多数个人开发者应选user installer;它无需管理员权限、配置隔离、卸载干净、更新稳定,而system installer仅适用于多用户共用或统一部署场景。

直接下载 Stable 版本的正确入口在哪
官网首页的绿色「Download」按钮默认就是 Stable 版,但很多人点错旁边的小箭头或「Download for Windows Stable Build」这类诱导链接,结果下到 User Installer(用户版)而非推荐的 System Installer(系统版)。Windows 用户应点击绿色按钮后,在弹出的平台列表里手动选「Windows」→「x64」(或「ia32」),而不是点下方带「Stable Build」字样的独立链接。
安装时该选 User Installer 还是 System Installer
普通用户选 User Installer 没问题,但若遇到权限报错、PATH 添加失败、或多用户共用机器,必须改用 System Installer。后者会写入系统级 PATH、支持静默部署、且不会因用户账户变更导致扩展丢失。macOS 和 Linux 用户无需纠结——Universal .dmg 和 .deb/.rpm 包天然就是系统级安装方式。
-
User Installer:自动更新更可靠,但仅对当前用户生效;卸载不干净可能残留%LOCALAPPDATA%\Programs\Microsoft VS Code -
System Installer:需管理员权限,路径固定为C:\Program Files\Microsoft VS Code;适合团队统一部署
勾选“添加到 PATH”为什么不能跳过
没勾这个选项,code 命令在终端里根本不可用,Git 集成、CLI 脚本、甚至部分插件(如 remote-ssh)都会失效。不是“可选”,而是“必须”。如果安装时漏了,后续手动加 PATH 很容易出错:Windows 要加到系统环境变量而非用户变量;macOS 需确认 shell 是 zsh 还是 bash,对应修改 ~/.zshrc 或 ~/.bash_profile;Linux 则要检查 /usr/bin/code 是否存在软链接。
装完发现是 Insiders 怎么办
常见原因是误点了官网下拉菜单里的 Insiders 下载项,或从非官网渠道(比如某些软件站、第三方镜像)下载。验证方式很简单:启动 VS Code 后看左下角状态栏——Stable 版显示的是版本号如 1.90.0,Insiders 版则明确标着 Insiders 字样。补救方法只有重装:去官网重新下载,安装时勾选「保留用户数据」,已装的扩展和 settings.json 不会丢。











