必须安装 microsoft 官方简体中文语言包（id：ms-ceintl.vscode-language-pack-zh-hans），认准蓝勾和 microsoft 署名；安装后需点击 restart now，并手动执行 configure display language 命令选择 zh-cn；若失败可直接编辑 locale.json 文件为 {"locale":"zh-cn"}。
必须装 Microsoft 官方中文语言包，其他都无效
搜“中文”“汉化”装的插件，99% 是第三方仿冒品，比如 Chinese Language Pack、VSCode Chinese Pro，它们只改菜单栏几个字，命令面板、错误提示、设置项全是英文，还可能触发 Cannot read property 'translate' of undefined 报错。真正起作用的只有一个：Chinese (Simplified) Language Pack for Visual Studio Code，发布者必须是 Microsoft，扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。
操作要点：
- 按
Ctrl+Shift+X（Windows/Linux）或Cmd+Shift+X（macOS）打开扩展面板 - 搜索完整名称
Chinese (Simplified) Language Pack for Visual Studio Code（注意大小写和空格） - 认准蓝勾图标 + “Microsoft”署名，点击 Install
- 安装后右下角弹出
Restart Now提示——必须点它，仅Reload Window不生效
Configure Display Language 命令只认 zh-cn
语言包只是翻译资源，“用哪套翻译”由 Configure Display Language 命令控制。它不会自动运行，也不出现在设置搜索里，必须手动执行。
操作步骤：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）呼出命令面板 - 输入完整命令名：
Configure Display Language（不能输成configure language或set locale） - 从下拉列表中**明确选择**
zh-cn（小写 + 连字符；zh_CN、ZH-CN、Chinese、zh-hans全无效，且不报错，静默失败） - 选完后弹窗提示“需要重启窗口”，必须点
Restart，否则locale.json不生成或不更新
手动编辑 locale.json 是最稳 fallback 方案
命令面板卡死、输不了字、或点了 zh-cn 重启后仍是英文？说明 VS Code 没成功写入配置。此时绕过 UI，直接改文件是最可靠解法。
操作步骤：
- 彻底退出 VS Code：Windows 查任务管理器杀光所有
Code.exe；macOS 在活动监视器结束Code Helper；Linux 运行pkill -f 'code' - 打开对应路径的
locale.json文件：
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"}（无 BOM、无多余空格、无逗号、JSON 格式合法） - 保存后全新启动 VS Code
Remote-SSH / WSL 下中文不生效，是因为远程没配
本地设好中文，连上 Remote-SSH 或 WSL 后还是英文？不是插件问题，而是远程实例运行的是独立的 VS Code Server，它读的是远程机器上的 locale.json，不继承本地配置。
解决方法：
- 确认远程服务已运行：
code --list-extensions能列出插件即说明 Server 在线 - 进入远程配置目录：
~/.vscode-server/data/Machine/xxx/locale.json（xxx是哈希后缀） - 新建或编辑该文件，内容仅一行：
{"locale":"zh-cn"} - 保存后，在远程窗口中执行
Developer: Reload Window
真正容易被忽略的是：终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变——那是它们各自的语言环境，不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn，这三处对了，就说明本体已生效。
