必须安装Microsoft官方中文语言包ms-ceintl.vscode-language-pack-zh-hans、执行Configure Display Language命令设locale为"zh-cn"、并彻底重启VS Code进程，三者缺一不可；装错第三方插件或未彻底重启是界面部分中文部分英文的最常见原因。
装错插件是中文不生效的最常见原因
VS Code 界面不汉化，90% 是因为装了非官方“中文插件”。真正起作用的只有一个：ms-ceintl.vscode-language-pack-zh-hans，对应扩展市场里显示为 Chinese (Simplified) Language Pack for Visual Studio Code，发布者必须是 Microsoft。
常见错误现象：
- 搜
chinese或中文装了Chinese Language Pack、VSCode Chinese等第三方包——它们不翻译命令面板、设置页、错误提示，还可能覆盖核心文案导致乱码 - 装了多个语言包（如简体+繁体），但 VS Code 只读
locale.json里指定的那个，其余资源被忽略 - 插件本身没做国际化（i18n），即使语言包装对，它的配置页仍显示英文——这不是你的配置问题，是插件作者的责任
Configure Display Language 命令只认严格格式的 zh-cn
装完语言包只是把翻译字典放进来了，VS Code 默认仍用英文启动。真正切换语言靠的是内置命令 Configure Display Language，它会写入 locale.json 文件，而不是改 settings.json。
关键细节：
- 命令名不含“中文”“汉化”，纯靠拼音缩写，搜
change language或chinese找不到 - 必须输入完整命令名：
Configure Display Language，回车后从下拉列表中手动选zh-cn -
zh_CN、ZH-CN、zh-hans、Chinese (Simplified)全无效，且无任何报错提示，界面静默保持英文 - 选完后弹窗提示“是否重启窗口”，必须点“是”；点“否”或关掉弹窗，配置根本不会写入
locale.json 手动配置必须路径对、格式严、进程净
当命令面板打不开、执行无反应、或重启后仍是英文，直接编辑 locale.json 是最稳的兜底方案。但它有三个硬性前提：
- 路径必须准确：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json - 文件内容只能有一行合法 JSON：
{"locale":"zh-cn"}（无多余空格、逗号、引号，编码为 UTF-8 无 BOM） - 保存后必须彻底退出所有 VS Code 进程：
Windows 查任务管理器中是否还有Code.exe
macOS 用活动监视器查Electron进程
残留进程会导致新启动时仍读旧缓存
settings.json 里加 locale 完全无效
很多人在 settings.json 里写 "locale": "zh-cn"，发现没变化——这不是你操作错，而是 VS Code 根本不识别这个字段。它只从 locale.json 读取界面语言配置。
容易踩的坑：
- 误改工作区
.vscode/settings.json：工作区设置对界面语言无效 - 编码不是 UTF-8 无 BOM：中文乱码或整行被忽略
- 重复写
"locale"key：JSON 解析失败，整个文件配置可能被跳过
右下角状态栏显示当前语言代码（如 zh-cn），点击它可快速切换，但仅限已安装对应语言包的前提下。插件界面、终端输出、Git 日志等保持英文，属于正常行为——它们走各自独立的本地化逻辑，不是汉化失败。
