必须运行configure display language命令并选zh-cn才能启用中文界面，该命令生成合法locale.json；其他路径配置、手动编辑或插件启用均无效。
Configure Display Language 命令没执行或选错语言值
装了 Chinese (Simplified) Language Pack for Visual Studio Code 但界面还是英文，大概率是压根没运行过 Configure Display Language。这个命令不是“可选步骤”，它是唯一能触发 VS Code 写入合法 locale.json 的入口。
常见错误包括：
- 在命令面板里输
change language或set locale，结果选中了错误命令（VS Code 不认这些模糊词） - 下拉列表里点了
zh、zh-TW或zh-hans—— 必须选zh-cn（全小写、带连字符） - 弹出提示后点了
Cancel或只按Developer: Reload Window—— 这不会加载新 locale，必须点Restart
locale.json 文件被覆盖、损坏或路径错误
VS Code 启动时只读一个固定路径的 locale.json：Windows 是 %APPDATA%\Code\User\locale.json，macOS 是 ~/Library/Application Support/Code/User/locale.json，Linux 是 ~/.config/Code/User/locale.json。其他地方写的 "locale": "zh-cn" 都无效。
这个文件内容必须严格为：
{"locale":"zh-cn"}
注意：双引号、冒号后无空格、zh-cn 全小写、无多余逗号或换行。任何偏差（比如 "ZH-CN"、{"locale": "zh-cn",}、文件为空、权限为只读）都会导致回退英文。
别手动创建或粘贴这个文件 —— 它必须由 VS Code 自己生成，否则可能被忽略。
工作区或远程环境强制覆盖 locale 设置
VS Code 的语言配置优先级是：远程实例 > 当前工作区 > 用户级。你本地设好了，一打开某个项目就变英文，八成是下面两个地方写了冲突配置：
- 当前项目根目录下的
.vscode/settings.json里有"locale": "en"或类似字段 - 用 Remote-SSH / WSL / Dev Containers 时，远程端的
locale.json是独立的，且不会同步本地设置
排查方法：
- 先执行
File > Close Folder，再运行Configure Display Language看是否生效 - 连上远程环境后，在远程会话里重新运行该命令，并确认远程路径
~/.vscode-server/data/Machine/settings.json里有{"locale":"zh-cn"}
插件资源损坏或缓存残留导致部分 UI 仍为英文
扩展管理器显示“已安装”，不代表翻译文件真的完整加载。网络中断、杀毒软件拦截、WSL 权限异常都可能导致关键文件 package.nls.zh-cn.json 缺失。
验证方式：
- 按
Ctrl+Shift+U打开输出面板 → 选择Log (Window)→ 搜索zh-cn或localization - 正常应看到
Loaded locale zh-cn from …；若出现Failed to load localization或路径指向空目录，说明资源损坏
解决办法：
- 卸载插件后，手动删掉扩展目录下整个
ms-ceintl.vscode-language-pack-zh-hans-*文件夹 - 清缓存：
%APPDATA%\Code\Cache（Win）或~/.vscode/Cache（macOS/Linux） - 重启 VS Code 后重装插件
最常被忽略的是：VS Code 的语言切换和插件启用完全解耦。哪怕你禁用了所有插件，只要没运行 Configure Display Language 并彻底重启，中文就不会出现 —— 这不是 Bug，是设计如此。
