必须手动创建locale.json文件,路径为Windows:%APPDATA%\Code\User\locale.json、macOS:~/Library/Application Support/Code/User/locale.json、Linux:~/.config/Code/User/locale.json,内容严格为{"locale":"zh-cn"}(UTF-8无BOM),并彻底退出VS Code进程后重启才生效。

离线安装完中文语言包后,必须手动创建并写入 locale.json,否则界面仍为英文——VS Code 不会自动写这个文件,也不读 settings.json 里的 locale 字段。
怎么找到并创建正确的 locale.json 路径
VS Code 只认特定路径下的 locale.json,其他位置全无效。别去 .vscode/ 工作区目录里找,也别放错成 settings.json 或 Locale.json(大小写敏感)。
- Windows:
%APPDATA%\Code\User\locale.json(即C:\Users\{用户名}\AppData\Roaming\Code\User\locale.json) - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
最稳方式:按 Ctrl+Shift+P → 输入 Developer: Open User Data Folder → 进入 User 目录,直接新建 locale.json 文件。
locale.json 内容必须严格合法,否则静默失败
VS Code 对该文件格式零容忍:一个空格、一个逗号、一个中文引号、或 UTF-8 BOM 都会导致它直接忽略整个文件,回退英文界面且不报错。
- 唯一合法内容(仅一行,无换行、无空格、无注释):
{"locale":"zh-cn"} - 常见非法写法:
{"locale": "zh-cn"}(冒号后空格)、{"locale":"zh_CN"}(下划线)、{"locale":"zh-hans"}(不识别)、{"locale":"zh-cn",}(尾随逗号)、{'locale':'zh-cn'}(单引号) - 编码必须是 UTF-8 无 BOM;用 VS Code 自己新建并保存,天然规避 BOM 问题;别用记事本(默认带 BOM)
改完不生效?90% 是没杀干净后台进程
Reload Window 完全没用——语言配置在主进程启动时就固化了,窗口重载不会重新读 locale.json。
- Windows:打开任务管理器 → 结束所有
Code.exe和Code Helper.exe进程(包括“后台进程”标签页) - macOS:活动监视器 → 搜索并强制退出全部
Electron和Code Helper进程 - Linux:终端执行
pkill -f "code.*--no-sandbox"或pkill -f "Code Helper" - 确认无残留后再全新启动 VS Code,右下角状态栏显示
zh-cn才算真正加载成功
Remote-SSH / WSL 下中文不生效?那是另一个实例
你在本地配好了 locale.json,连上远程机器后仍是英文——这不是配置错了,而是 Remote-SSH 或 WSL 启动的是独立的 VS Code Server 实例,它只读远程机器上的配置。
- 远程端需单独操作:连接后按
Ctrl+Shift+P→Developer: Open User Data Folder→ 进入其User目录,同样新建locale.json并填入{"locale":"zh-cn"} - 远程端的中文语言包也得单独安装(离线拷贝 .vsix 后用命令面板安装)
- 本地改的
locale.json对远程完全无效,二者配置完全隔离
最容易被忽略的一点:语言包和 locale.json 是两件事——前者是“字典”,后者是“开关”。缺一不可,且都必须在对应环境(本地/远程)中各自完成。


















