必须安装Microsoft官方中文语言包（ID：ms-ceintl.vscode-language-pack-zh-hans），执行Configure Display Language命令选zh-cn，并彻底重启VS Code进程；装错插件或仅重载窗口会导致乱码、报错或界面仍英文。
装错插件会导致命令面板乱码或 Cannot read property 'translate' of undefined
搜“中文”“汉化”“chinese”很容易点进非官方插件，比如 Chinese Language Pack、VSCode Chinese 或带“Pro”“Ultimate”的第三方包。这些插件不维护、翻译残缺，有的还会偷偷改 locale.json，导致后续所有语言设置失效。
必须只认准一个插件：Chinese (Simplified) Language Pack for Visual Studio Code，发布者是 Microsoft，扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。安装后右下角必须点 Restart Now —— 点 Reload Window 或只关窗口不杀进程，等于没装。
- Windows：检查任务管理器里是否还有
Code.exe进程 - macOS：活动监视器中结束
Code Helper和Electron相关进程 - Linux：运行
pkill -f code确保无残留
Configure Display Language 命令只认 zh-cn，其他写法全无效
这个命令不是靠“选中文”生效的，它本质是往 locale.json 写值。下拉列表里显示的 Chinese (Simplified) 是障眼法，真正起效的只有代码值 zh-cn。大小写、连字符、下划线错一个，配置就静默失败，且不报错。
常见错误写法：zh_CN、ZH-CN、zh-CN、Chinese、zh cn —— 全部无效。
- 必须用快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）呼出命令面板 - 完整输入
Configure Display Language（注意空格和大小写） - 从下拉列表中明确点击
zh-cn项（不是搜索匹配，不是输拼音） - 弹窗提示后必须点
Restart，不是Reload Window
手动编辑 locale.json 是最稳的兜底方案
当命令面板打不开、列表没 zh-cn、反复重启仍是英文时，直接改配置文件最可靠。它的优先级高于 UI 操作，且不依赖插件状态或命令面板可用性。
路径和格式稍有偏差就失效：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
文件内容只能是严格的一行 JSON：{"locale":"zh-cn"}。必须 UTF-8 编码、无 BOM、无多余空格或逗号。用 VS Code 自己打开并保存，右下角确认状态栏显示 UTF-8，别用记事本或 Sublime。
终端、调试控制台、Git 日志显示英文 ≠ 汉化失败
顶部菜单栏、左侧活动栏 hover 提示、设置界面（Ctrl+,）搜索 locale 显示值为 zh-cn —— 这三处全中文，说明汉化成功。
但终端输出、调试控制台、Git 日志、部分插件弹窗默认不走 VS Code 的 locale 配置，而是各自读系统 locale 或 shell 环境变量。这不是 bug，是设计如此。
远程开发（Remote-SSH / WSL）下仍为英文，是因为远程实例运行的是独立的 VS Code Server，它读的是远程机器上的 locale.json，不是本地的。
