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 Toolkit

使用 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，这三处全中文才算到位。