必须安装microsoft官方语言包ms-ceintl.vscode-language-pack-zh-hans，执行configure display language命令设locale为"zh-cn"，并彻底重启vs code进程；搜“中文”“汉化”等易装错第三方插件，无效且可能引发乱码。
只装 Microsoft 官方语言包，别信“汉化”“中文插件”
VSCode 没有内置简体中文界面，所有中文显示都依赖扩展机制。唯一有效的语言包是 Chinese (Simplified) Language Pack for Visual Studio Code，发布者必须是 Microsoft，扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。搜“中文”“汉化”“zh-cn”出来的绝大多数第三方包——比如 Chinese Language Pack 或 VSCode Chinese——图标模糊、描述带广告、更新停滞，装了也不生效，还可能污染命令面板或导致设置页乱码。
操作路径：Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）打开扩展面板 → 严格粘贴全名 Chinese (Simplified) Language Pack for Visual Studio Code 搜索 → 只点那个带蓝白 VS Code logo + 中文“中”字图标的选项 → 点击 Install。
注意：
- 如果搜不到，大概率是 VS Code 版本低于 1.13，需先升级
- 离线环境可去 GitHub 下载
vscode-language-pack-zh-hans.vsix，用命令code --install-extension xxx.vsix安装 - 安装后右下角弹出的
Reload Window提示不要点——它不切换语言，只重载插件逻辑
Configure Display Language 命令必须手动触发
语言包只是“翻译字典”，真正告诉 VS Code “请用中文”的动作是 Configure Display Language 命令。这个命令不会自动运行，也不会出现在设置界面里，必须手动调用。
操作路径：Ctrl+Shift+P 打开命令面板 → 输入并选择 Configure Display Language → 回车 → 在弹出列表中选 zh-cn（注意：必须小写、短横线、双引号包裹；zh_CN、zh-hans、Chinese 全无效）→ 点击提示中的 Restart。
常见错误现象：
- 命令面板里搜不到
Configure Display Language→ 语言包根本没装成功，或安装后没彻底重启过任何窗口 - 搜到了但选完
zh-cn后界面仍是英文 →locale.json路径不对，或文件编码不是 UTF-8 无 BOM - 点了
Reload Window就以为完成 → 这个操作只刷新 UI，不重载语言环境
手动编辑 locale.json 是最可靠的兜底方案
当命令面板卡死、UI 崩溃、远程开发环境无法联网、或批量部署时，直接改配置文件最稳。VS Code 启动时优先读取 locale.json，它的优先级高于 settings.json 中的 locale 字段。
操作路径：彻底关闭所有 VS Code 窗口（Windows 查任务管理器中所有 Code.exe 进程；macOS 查活动监视器里的 Electron；Linux 用 pkill code）→ 找到并用任意编辑器打开：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
写入且仅写入这一行：{"locale":"zh-cn"}（UTF-8 编码、无 BOM、无多余空格或逗号）→ 保存 → 全新启动 VS Code。
重启必须“彻底”，不能只点 Reload Window
Reload Window 和 Restart 是两回事：Reload Window 只重载插件和 UI 渲染层，不重新加载语言环境；而 Restart 会杀掉主进程、清空缓存、重新初始化本地化模块。
如果你点了 Restart 后仍无效，说明后台还有残留进程。务必确认：
- Windows：任务管理器中没有
Code.exe进程 - macOS：活动监视器中没有
Electron或Code Helper - Linux：
ps aux | grep code返回为空
语言切换真正的生效点，不在插件安装那一刻，也不在命令面板选中那一刻，而是在你关掉最后一个窗口、杀掉最后一个进程、再双击图标启动的那一刻。这是最容易被忽略、也最常导致“明明装了却还是英文”的原因。
