装了中文插件设置页仍是英文,是因为vs code仅依据locale.json中"locale":"zh-cn"字段切换语言;必须通过configure display language命令或手动编辑该文件并重启窗口才能生效。

为什么装了中文插件,设置页还是英文?
因为插件只是提供翻译资源,VS Code 启动时只读取 locale.json 里的 "locale" 字段来决定用哪套翻译。默认是 "en",不改这个值,菜单、命令面板、设置页(Ctrl+,)全保持英文。
常见错误包括:
- 只安装了
Chinese (Simplified) Language Pack for Visual Studio Code,但没执行Configure Display Language命令 - 把
"locale": "zh-cn"错加到settings.json里——VS Code 完全忽略该字段 - 在命令面板里选了“简体中文”文字项,而不是代码标识符
zh-cn - 写成
"zh_CN"、"zh-hans"、zh-cn(漏引号)、"Chinese",全部静默回退英文
Configure Display Language 命令怎么用才有效?
这是唯一面向用户的可靠入口,它会自动创建或修正 locale.json 文件,避免路径、格式手误。
操作要点:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Configure Display Language并回车 - 在弹出列表中明确点击
zh-cn这一项(不是旁边的文字说明) - 看到提示“需要重启窗口以应用更改”,必须点
Restart——Developer: Reload Window不重载语言环境,无效 - 重启后右下角状态栏应显示
zh-cn,不是en
手动编辑 locale.json 的硬性要求
当命令面板打不开、或列表里没有 zh-cn 时,直接改配置文件是最稳妥的备用方案,但路径和内容必须严格匹配。
关键细节:
- 文件路径必须是用户级目录:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容只能是纯 JSON 格式,且仅含一行:
{"locale": "zh-cn"}
→ 注意:双引号、英文冒号、英文逗号、小写字母、短横线,缺一不可 - 如果文件已存在且含其他字段,删掉所有非
"locale"的键值对,避免语法错误导致整个文件被忽略 - 改完后必须彻底退出 VS Code 进程:Windows 查任务管理器中残留的
Code.exe,macOS 查活动监视器里的Electron,否则新窗口仍继承旧语言环境
插件装错或没装对的典型表现
搜“中文”“汉化”容易点进非 Microsoft 签名的扩展,比如 Chinese Language Pack 或 VSCode Chinese,它们不是标准语言包,会导致:
- 设置页部分字段乱码或不翻译
- 命令面板输入框上方提示变成方块或问号
- Git 面板、调试控制台等区域语言不一致
正确插件只有这一个:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。安装后右下角若弹出提示,务必点 Change and Restart,而不是只点 Reload。
最常被跳过的动作是关不干净——后台进程还在跑,新窗口复用旧环境,看起来像没生效。验证前先确认右下角状态栏显示的是 zh-cn,不是 en。











