必须执行 configure display language 命令并选 zh-cn,否则插件无效;该命令自动生成严格格式的 locale.json 文件,路径和内容错误或手动创建均导致静默失败,且新版 vs code 已弃用 settings.json 设置方式。

必须执行 Configure Display Language 命令并选 zh-cn,否则插件只是“摆设”——装十遍也没用。
为什么重启后还是英文?Configure Display Language 没真运行
插件只提供翻译资源,不自动激活语言。VS Code 不会根据插件安装状态反向改 locale。你点“重新加载窗口”、手动关再开、甚至杀掉所有 Code.exe 进程但没走这步命令,locale.json 就不会生成或写对值。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),**严格输入Configure Display Language**(大小写、空格都不能错) - 从下拉列表里选
zh-cn——不是zh、zh-CN、Chinese (Simplified),也不是zh-hans - 弹出提示后,**必须点 Restart**;点 “Don’t Restart” 或只关窗口再手动打开,
Code Helper进程可能仍在后台,配置不加载
locale.json 文件路径和内容必须完全正确
VS Code 只读特定路径下的 locale.json,其他地方写的 "locale": "zh-cn" 都无效。它内容也极其敏感:多一个空格、少一个引号、用了中文标点,就会静默失败,退回英文。
- 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"}(无注释、无多余逗号、双引号为英文、全小写、连字符) - 别手动生成这个文件——它必须由 VS Code 自己写入;否则即使内容对,也可能被忽略
工作区或远程环境覆盖了用户级设置
VS Code 的 locale 设置支持三层优先级:用户级 .vscode/settings.json 里写了 "locale": "en",就能把你的中文干掉。
- 临时关闭当前文件夹(
File > Close Folder),再运行Configure Display Language测试是否生效 - 远程开发(SSH / Dev Container)时,远程端有独立的
locale.json,需在远程窗口里再次执行该命令 - 检查工作区根目录下
.vscode/settings.json是否存在冲突项;企业环境中还要排查 GPO 或策略插件是否锁定了locale - 启动时加参数验证:
code --log trace,看输出面板中Log (Window)里是否有--locale=zh-cn
装错了插件或缓存残留导致半汉化
搜“chinese”出来一堆同名插件,但只有发布者是 Microsoft、ID 是 ms-ceintl.vscode-language-pack-zh-hans 的才是官方包。装错会导致菜单乱码、快捷键提示仍是英文,甚至和补丁类插件冲突。
- 卸载所有非 Microsoft 发布的中文相关插件,只留
Chinese (Simplified) Language Pack for Visual Studio Code - 终端执行
code --disable-extensions启动,若此时中文正常、菜单可点,说明问题出在第三方插件干扰 Extension Host - 用
Developer: Start Extension Bisect二分定位崩溃插件;或打开开发者工具(Ctrl+Shift+I),切到Console标签页搜Activating extension或Cannot read property - Windows 用户清资源加载缓存,macOS 用户重置字体渲染缓存——部分 UI 元素卡在英文状态,常因旧缓存未清干净
真正生效的关键就落在 Configure Display Language 命令是否被执行、zh-cn 是否被准确选中、以及 locale.json 是否由 VS Code 在正确路径下写入了严格格式的内容。其余操作都是绕路。尤其注意:新版 VS Code(1.70+)已弃用通过 settings.json 设置 locale 的方式,改那里毫无意义。











