必须手动创建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 不会自动创建 locale.json,装完语言包也不代表它存在。必须手动创建或编辑,且路径因系统而异:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json
注意:~/.vscode/locale.json 或 settings.json 里加 "locale": "zh-cn" 都无效——VS Code 完全不读这两个位置的语言配置。
locale.json 内容格式必须严格合规
文件内容只能是单行标准 JSON,无 BOM、无空格、无注释、无多余逗号:{"locale":"zh-cn"}
以下写法全部失效:
– {"locale": "zh_CN"}(下划线)
– {"locale":"zh-hans"}(BCP 47 不兼容)
– {"locale":"Chinese"}(非标准标识符)
– {"locale":"zh-cn", "foo":1}(多字段直接被忽略)
编码必须为 UTF-8 无 BOM;用记事本保存易带 BOM,建议用 VS Code 自己新建并选“UTF-8”编码保存。
为什么改了 locale.json 还是英文?进程没杀干净
VS Code 启动后常驻后台进程(如 Windows 的 Code.exe、macOS 的 Electron 或 Code Helper),仅关闭窗口不等于退出。必须:
– Windows:打开任务管理器,结束所有 Code.exe 进程
– macOS:在活动监视器中强制退出 Electron 和 Code Helper
– Linux:运行 pkill -f "code.*--no-sandbox" 或检查 ps aux | grep code
重启时务必双击图标或终端执行 code,不要用 “Reload Window”。右下角状态栏显示 en 就说明旧进程还在跑。
验证是否真正生效,只盯三处
终端、调试控制台、Git 日志、右键菜单显示英文不是汉化失败——它们不走 locale.json 配置。真正判断依据只有:
– 顶部菜单栏是否显示「文件」「编辑」「视图」
– 命令面板(Ctrl+Shift+P)上方提示是否为「请输入命令或搜索设置」
– 设置界面(Ctrl+,)左侧导航是否为「用户」「工作区」「扩展」
这三处全中文,locale.json 就算配对了。其他地方的英文,是设计如此,不是你漏了哪步。


















