vscode界面语言切换应使用configure display language命令自动写入settings.json的"locale":"zh-cn",需安装官方中文语言包并完全重启;locale.json文件不存在于1.30+版本配置体系中。

VSCode 界面语言切换不靠改系统 locale,也不靠新建 locale.json——这个文件根本不存在于当前版本(1.30+)的配置体系中。真正起作用的只有一条设置:"locale": "zh-cn",且必须配合官方中文语言包 + 完全重启。
安装 Chinese (Simplified) Language Pack 扩展
没装这个扩展,设了 "locale": "zh-cn" 也白搭。VSCode 不会报错,但界面始终英文。
- 按
Ctrl+Shift+X(Win/Linux)或Cmd+Shift+X(Mac)打开扩展面板 - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code,认准 Microsoft 官方蓝勾标识 - 点击 Install,右下角弹窗出现后,务必点 Change and Restart(不是只点 Install)
- 若扩展图标变灰,说明被禁用:右键扩展 → Enable
用 Configure Display Language 命令设置 zh-cn
这是最稳妥的方式,它会自动写入正确的 "locale": "zh-cn" 到 settings.json,并避开路径、大小写、层级冲突等问题。
- 按
Ctrl+Shift+P(或Cmd+Shift+P)打开命令面板 - 输入
Configure Display Language,回车 - 在弹出列表中选择
zh-cn(注意:只有小写zh-cn被识别;zh_CN、ZH-CN、zh全无效) - 点 Restart 按钮——不是 Reload Window,是彻底退出再重开
手动修改 settings.json 的注意事项
如果命令面板失效或想批量部署,可直接编辑 settings.json,但必须满足三个条件才生效:
- 该设置必须写在用户级或工作区级的
settings.json中,不能写在keybindings.json或其他配置文件里 - 确保没有被命令行启动参数覆盖:比如终端执行
code --locale=en会强制覆盖设置 - macOS / Linux 下从 Dock 或桌面图标启动时,可能忽略
settings.json中的locale;此时需改用命令行启动:code --locale=zh-cn,或编辑桌面启动器的Exec=行加入该参数
为什么改了还是英文?优先排查这三点
不是配置写错了,而是环境干扰了生效逻辑。
- 检查是否安装了多个语言包(比如同时装了简体和繁体),VSCode 可能加载了错误的那个
- 打开命令面板,输入
Developer: Show Running Extensions,确认Chinese (Simplified) Language Pack状态是 “Running”,不是 “Disabled” 或 “Not activated” - 工作区
.vscode/settings.json中若也写了"locale",它会覆盖用户级设置;用Ctrl+Shift+P→Preferences: Open Settings (JSON)看清当前编辑的是哪一级
最常被忽略的一点:VSCode 的语言包机制是“扩展驱动 UI 翻译”,不是“系统级汉化”。所以部分第三方插件(如 Python、Remote-SSH)的菜单、提示仍可能是英文——这不是 VSCode 本体没切成功,而是那些插件自己没提供中文资源,得单独查它们的文档或设置项。











