必须从code.visualstudio.com下载官方安装包，第三方“中文版”含捆绑广告、篡改命令或禁用更新；VSCode无中文安装包，仅提供英文安装包加Microsoft官方中文语言插件；安装路径须纯英文无空格，否则导致插件异常；code命令需重启终端或刷新shell配置才能生效。
VSCode 官方安装包必须从 code.visualstudio.com 下载
第三方所谓“中文版安装包”全是风险源，不是捆绑广告就是篡改 code 命令行为，甚至禁用自动更新。VSCode 本身没有中文安装包——它只有英文安装包 + 独立语言插件。认准官网域名 code.visualstudio.com，页面会自动识别系统并推荐对应版本：VSCodeUserSetup-x64-*.exe（Windows 用户级）、VSCode-darwin-universal.zip（macOS）、code_*.deb（Ubuntu/Debian）。下载前务必核对文件名后缀和系统架构，比如 Windows 10/11 64 位只能用 x64 版，别误选 ia32。
安装路径含中文或空格会导致插件加载失败
常见现象是扩展面板里插件显示“已安装”，但图标灰掉、无法启用，或者点击安装后无反应、控制台报 ENOENT 错误。根本原因是部分插件（尤其是依赖本地二进制的，如 Prettier、ESLint）在解析路径时遇到中文或空格会截断或转义异常。正确做法是：安装时点击「浏览」自定义路径，用纯英文命名，例如 D:\VSCode 或 C:\vscode，绝对不要写成 D:\VS Code 或 D:\编程工具\VSCode。
中文语言包必须装 Microsoft 官方发布的那个
在扩展面板（Ctrl+Shift+X）搜索 Chinese (Simplified)，结果里只认准这一项：Chinese (Simplified) Language Pack for Visual Studio Code
发布者必须是 Microsoft，不是 Chinese Language Pack 或 VSCode Chinese 等仿冒名称。安装后不会立即生效——必须点击右下角弹出的 Change Language and Restart，或手动修改配置：
"locale": "zh-CN"
该配置要写在用户设置（
settings.json）里，而非工作区设置，否则换项目就回英文。
code 命令不可用不是插件问题，是 PATH 没刷进去
勾选了「添加到 PATH」但终端输 code -v 报 command not found，这不是插件没装好，而是环境变量延迟加载。Windows 用户需关闭所有 CMD/PowerShell/Windows Terminal 窗口再新开一个；macOS/Linux 用户执行 source ~/.zshrc（或 ~/.bash_profile）即可。验证方式只有 code -v 能输出版本号才算真正生效——仅靠图形界面能打开，不代表命令行集成成功。
