VSCode界面中文不生效的主因是locale.json文件路径错误、内容格式错误或进程未彻底退出;该文件必须位于用户数据目录下,内容严格为{"locale":"zh-cn"},且需彻底重启生效。

VSCode 界面中文显示不生效,90% 是因为 locale.json 文件路径错、内容错,或进程没彻底退出——装对插件只是前提,locale.json 才是最终开关。
locale.json 文件必须放在用户数据目录下,不是安装目录
这个文件 VS Code 不会自动生成,也不在你双击安装的程序路径里。它只存在于用户配置目录中,系统不同路径也不同:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
常见错误是去 C:\Program Files\Microsoft VS Code 或 /usr/share/code 下找,那里面没有 locale.json,改了也没用。重装或换账号后该文件容易丢失,界面就自动回退英文,且无任何提示。
文件内容只能是严格格式的单行 JSON
locale.json 不是 settings 配置文件,它只认一个字段,且格式极其敏感:
使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 必须是纯 JSON,仅且仅有:
{"locale":"zh-cn"} - 双引号不能换成中文引号,
zh-cn必须全小写、带短横线、不能是zh_CN、zh-hans、Chinese或zh - 不能有多余空格、逗号、换行,不能有 UTF-8 BOM 头(用 VS Code 自己打开保存可避免)
- 如果文件里混了其他字段(比如
"theme": "dark"),整个文件会被忽略,静默失效
改完必须彻底重启,Reload Window 完全无效
VS Code 的语言上下文在进程启动时读取 locale.json,运行中改了也不会重载:
- 关闭所有窗口,再检查后台进程:Windows 看任务管理器有没有残留
Code.exe,macOS 看活动监视器里的Electron和Code Helper - Linux 可执行
pkill -f "code.*--no-sandbox"确保清干净 - 全新启动 VS Code,右下角状态栏会显示当前语言代码(如
zh-cn),点它还能快速切换
很多用户点了 Reload Window 就以为生效了,结果菜单栏还是英文——那是假象,新窗口根本没读新配置。
别往 settings.json 里写 locale 字段
settings.json 里加 "locale": "zh-cn" 完全无效,VS Code 根本不识别这个字段。它只在 locale.json 中起作用。有些教程教你在设置 JSON 里硬塞,反而干扰判断,还可能被企业策略或工作区配置覆盖。
真正容易被忽略的是:终端、调试控制台、Git 日志这些地方显示英文,不是 locale.json 没配好,而是它们根本不走 VS Code 的 locale 机制——盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处全中文才算到位。

















