vs code 中文界面生效必须将 {"locale":"zh-cn"} 严格写入用户级 locale.json 文件,路径为 windows %appdata%\code\user\locale.json、macos ~/library/application support/code/user/locale.json 或 linux ~/.config/code/user/locale.json,保存后须彻底退出进程并全新启动,右下角显示 zh-cn 即生效。

locale.json 文件必须放在用户级配置目录下
VS Code 只认特定路径下的 locale.json,放错位置等于没改。它不读工作区(.vscode/locale.json)、不读系统级路径、也不读 settings.json 里的同名字段。
正确路径只有这三处:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
如果目录不存在,先手动创建完整路径(比如 Linux 下执行 mkdir -p ~/.config/Code/User),再建文件。别用 ~/.vscode/locale.json —— 这是旧版或错误路径,VS Code 1.70+ 已弃用。
内容必须是严格合法的单行 JSON
locale.json 不是 settings.json,不能加注释、不能多逗号、不能有 BOM、不能换行。VS Code 读到非法格式会静默忽略,界面照旧英文,且不报错。
只允许这一种写法:
{"locale":"zh-cn"}
注意以下细节:
- 键名
locale必须带双引号 - 值
zh-cn必须小写、连字符、无空格 - 不能写成
zh_CN、ZH-CN、Chinese或zh-hans - 整个文件就是这一行,不要空行,不要 UTF-8 BOM(用 VS Code 自己新建并保存最安全)
改完必须彻底退出 VS Code 再启动
“重新加载窗口”(Reload Window)对 locale.json 无效——它不会重读该文件。必须杀掉所有后台进程,再全新启动。
验证是否清干净:
- Windows:打开任务管理器,确认没有
Code.exe进程残留 - macOS:活动监视器中搜索
Electron或Code Helper,全部结束 - Linux:
pkill -f "Code Helper\|Electron"或ps aux | grep code检查
重启后,右下角状态栏会显示当前语言代码(如 zh-cn),点它可快速切换,这是最直接的生效标志。
中文不生效?先检查语言包是否就绪
locale.json 是开关,但语言包才是字典。没有安装官方中文资源,设成 zh-cn 也会回退到英文,且无提示。
验证方式很简单:
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language - 如果下拉列表里有
zh-cn选项,说明语言包已内置就绪(VS Code 1.76+ 默认集成) - 如果列表为空或只有
en,说明你可能在 Remote-SSH / WSL 环境中——远程实例需单独配远程端的locale.json和语言环境
真正容易被忽略的是:终端面板、调试控制台、Git 输出默认不随 locale.json 变,这不是配置失败,而是它们各自依赖系统 locale 或插件实现。











