必须执行Configure Display Language命令并选zh-cn后重启，仅装中文包无效；该命令是唯一能生成正确locale.json并激活中文的入口。
Configure Display Language 命令根本没执行
装了中文包但界面仍是英文，90% 是因为跳过了这一步——Configure Display Language 命令才是唯一能激活语言包的开关，插件本身只提供翻译资源，不自动切换语言。
常见错误现象：
- 命令面板（
Ctrl+Shift+P）里搜不到Configure Display Language—— 说明语言包根本没装成功或被禁用 - 搜到了但下拉列表为空，或只有
en没有zh-cn—— 插件未识别，需重装官方包 - 点了
zh-cn后弹出 “Restart to apply changes” 却点了 Cancel 或只 Reload Window —— 配置不会落盘
必须严格按顺序操作：
- 按
Ctrl+Shift+P（macOS 用Cmd+Shift+P），输入完整命令名：Configure Display Language - 从下拉项中**明确点击**
zh-cn（不是zh、zh_CN、Chinese、zh-hans） - 弹窗后点
Yes，不是关闭窗口再手动打开；Reload Window不会重新加载语言资源
locale.json 路径错、内容错、权限错
locale.json 是 VS Code 实际读取语言配置的唯一文件，它不认 settings.json 里的 "locale" 字段（1.70+ 版本已弃用）。这个文件必须在用户级路径下，且内容严格受限。
正确路径：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
文件内容必须是且仅是这一行（无空格、无 BOM、UTF-8 编码）：
{"locale":"zh-cn"}容易踩的坑：
- 手动生成该文件，VS Code 可能静默忽略——应优先通过
Configure Display Language命令生成 - 写成
{"locale": "zh_CN"}或{"locale": "zh"}—— 全部无效，且无任何提示 - 文件存在但权限为只读（尤其 WSL 或远程挂载场景），VS Code 写入失败后 fallback 英文
- 误放在工作区
.vscode/下或系统级路径，VS Code 完全不读
远程开发（SSH/WSL）下中文失效
本地设好了，连上 Remote-SSH 或 WSL 后界面又变英文？这不是 bug，是设计如此：远程实例运行的是独立的 VS Code Server，它读取的是远程机器上的 locale.json，和本地完全无关。
必须单独处理远程端：
- 先确认远程已安装官方语言包：
code --list-extensions | grep ms-ceintl - 登录远程终端，定位并编辑远程
locale.json（不是本地路径）： - WSL/Linux：
~/.vscode-server/data/Machine/locale.json（注意不是~/.config/Code/User/） - Remote-SSH：
~/.vscode-server/data/Machine/<hash>/locale.json</hash>，<hash></hash>是当前服务实例目录名 - 内容仍为
{"locale":"zh-cn"}，保存后在远程窗口中执行Developer: Reload Window - 若远程没装语言包，即使
locale.json正确也无翻译资源可用
插件装错或被污染
搜“中文”“汉化”“zh-cn”安装的第三方插件（如 Chinese Language Pack、VSCode Chinese）基本都不可靠。它们不维护、不更新，轻则菜单乱码，重则触发 Cannot read property 'translate' of undefined 报错，甚至让 Configure Display Language 命令在命令面板里直接消失。
唯一有效的是微软官方插件：
- 名称必须是：
Chinese (Simplified) Language Pack for Visual Studio Code - ID 必须是：
ms-ceintl.vscode-language-pack-zh-hans - 发布者必须是：
Microsoft，图标带蓝勾认证
验证方式：
- 执行
Extensions: Show Installed Extensions，确认该插件在列表中且状态为Enabled - 若已安装但禁用，手动启用后再试命令
- 若不在列表中，卸载所有疑似中文插件，再重新安装官方包
装完右下角必须弹出 Restart Now 提示——必须点它；Reload Window 不会加载语言资源。
彻底退出 VS Code（Windows 查任务管理器杀光 Code.exe；macOS 运行 killall -u $USER 'Code Helper'），再启动，否则旧进程残留会继承英文环境。
