新建并配置 locale.json 是当前最稳、最直接的中文界面生效方式,因其绕过 ui 层强制指定语言上下文;vs code 1.70+ 已移除 settings.json 中的 locale 字段,仅用户级 locale.json 文件有效,路径、编码(utf-8 无 bom)、json 格式及小写 zh-cn 值必须严格正确,且需彻底重启验证 file 菜单、活动栏提示和设置搜索框。

VSCode 新建并配置 locale.json 是当前最稳、最直接的中文界面生效方式,尤其当命令面板打不开、Configure Display Language 失效或重启后仍英文时——它绕过 UI 层,强制指定语言上下文。
为什么必须新建 locale.json 而不是改 settings.json
从 VS Code 1.70 版本起,locale 字段已从 settings.json 中移除;写入 "locale": "zh-cn" 完全无效,VS Code 不识别也不报错。真正起作用的只有独立的 locale.json 文件,且只读取用户级路径下的该文件。
-
settings.json里加locale字段 → 白写,不生效 - 插件安装了但没配
locale.json→ 翻译资源“在仓库里”,界面还是英文 - 远程开发(WSL / Remote-SSH)需单独配远程机器上的
locale.json→ 本地配了,远程窗口仍是英文
locale.json 的正确路径和创建方式
路径必须严格匹配系统,且文件名不能拼错(比如写成 local.json 或 locale.js);目录不存在时需手动创建父路径。
- Windows:
%APPDATA%\Code\User\locale.json(即C:\Users\用户名\AppData\Roaming\Code\User\locale.json) - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json - WSL 远程环境:
$HOME/.vscode-server/data/Machine/xxx-hash-xxx/locale.json(需先确认code --list-extensions已运行,再进对应 Machine 目录)
推荐用终端一行创建(避免编码问题):
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
mkdir -p ~/.config/Code/User && echo '{"locale":"zh-cn"}' > ~/.config/Code/User/locale.json
注意:值必须是小写 zh-cn,不是 zh_CN、Zh-cn、Chinese 或带空格的字符串。
保存和重启的关键细节
文件内容看似简单,但三个隐藏坑常导致失败:
- 编码必须是 UTF-8 无 BOM:用 VS Code 自己新建并保存,别用记事本或 Sublime 直接覆盖
- JSON 必须合法:外层大括号、键和字符串值都用双引号、无尾逗号、无多余空格或换行
- 重启必须彻底:Windows 查任务管理器杀光所有
Code.exe;macOS 在活动监视器结束Electron及Code Helper进程;Linux 用pkill -f "code"
重开后验证是否生效,只看三处:File 菜单文字、左侧活动栏 hover 提示、设置页搜索框占位符是否为“搜索设置”。其他区域(如集成终端、Git 输出、调试控制台)显示英文属正常,它们不走 VS Code 主 locale 控制流。
最容易被忽略的是:右下角状态栏点击语言代码可快速切换,但它只对当前窗口生效;要全局稳定,locale.json 必须存在于用户级路径,且内容一字不差。










