VSCode无独立中文版，需下载官方英文安装包并安装Microsoft发布的简体中文语言包；安装时选用户级版本、路径不含中文或空格、勾选添加到PATH；语言包安装后需重启，并确认locale设为"zh-CN"。
VSCode 没有独立的“中文版安装包”，所谓“中文版”只是安装后通过语言包切换界面语言——直接下载官网英文安装包，再装微软官方 Chinese (Simplified) Language Pack for Visual Studio Code 即可，全程免费、安全、无兼容风险。
VSCode 官网下载时别选错安装包类型
打开 https://code.visualstudio.com/ 后，页面会自动识别系统并推荐对应版本。注意以下几点：
- Windows 用户优先选
VSCodeUserSetup-x64-*.exe（用户级安装），不需管理员权限，不影响其他账户 - 避免下载第三方打包的“绿色版”或“汉化版”安装包——它们可能篡改核心文件、注入广告、禁用自动更新
- 安装路径中不要含中文或空格（例如
D:\VS Code❌，应为D:\VSCode✅），否则部分插件或终端命令可能异常 - 安装向导第 4 步「选择附加任务」里，
添加到 PATH必须勾选，否则后续在终端输入code .会提示“command not found”
安装完 VSCode 后，中文语言包必须认准 Microsoft 官方发布者
启动 VSCode，按 Ctrl+Shift+X 打开扩展面板，搜索关键词 Chinese (Simplified)。你会看到多个结果，只装这个：
- 名称：
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者：
Microsoft（不是 “Chinese Language Pack” 或 “VSCode Chinese” 等非官方变体） - 下载量：通常显示 >1000 万次（可作为辅助判断依据）
- 安装后弹出提示框时，点
Restart Now；若没弹窗，手动重启 VSCode 即可生效
汉化失败？先检查 locale 设置是否被覆盖
极少数情况（比如之前装过其他语言插件、或修改过配置文件），即使装了中文包仍显示英文。此时需手动确认显示语言设置：
- 按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language并回车 - 在弹出的 JSON 文件中，确认
"locale"字段值为"zh-CN"（不是"en"、"zh"或空字符串） - 保存文件后必须重启 VSCode——仅重载窗口无效
- 如果该设置被工作区
.vscode/settings.json覆盖，需同步检查工作区配置
code 命令不可用？PATH 配置延迟生效是常见原因
勾选了「添加到 PATH」但终端仍报错 command not found: code，不是安装失败，而是环境变量未刷新：
- Windows：重启终端（CMD/PowerShell/Windows Terminal）或重启电脑；旧终端进程不会自动继承新 PATH
- macOS/Linux：执行
source ~/.zshrc（或~/.bash_profile）重新加载 shell 配置 - 验证是否生效：在新终端中运行
code -v，能输出版本号即成功 - 注意：某些终端（如 Git Bash）默认不读取系统 PATH，需额外配置
