90%是locale.json路径或内容错误:必须位于用户级目录,内容严格为{"locale":"zh-cn"}(小写、短横线、无空格、无注释),且需彻底退出VS Code进程后重启。

装了中文语言包但界面仍是英文,90% 是因为 locale.json 没写对、没放对位置,或根本没生效——不是插件问题,是配置没命中。
locale.json 文件必须放在正确路径且内容严格合法
VS Code 只读取用户级配置目录下的 locale.json,其他任何位置(比如工作区 .vscode/ 下、settings.json 里、甚至远程环境的同名文件)都无效。内容也极其敏感:
- 路径必须准确:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容只能是单行合法 JSON:
{"locale":"zh-cn"}(注意:全小写、短横线、英文双引号、无空格、无 BOM、无逗号、无注释) - 写成
{"locale": "zh_CN"}、{"locale":"Chinese"}、{"locale":"zh-hans"}或多一个空格,都会静默失败,退回英文
手动创建 locale.json 前必须彻底退出 VS Code
后台进程(如 Code Helper、Code.exe)不退出,新写的 locale.json 就不会被加载。这不是“重启窗口”能解决的:
- Windows:打开任务管理器,杀掉所有
Code.exe进程 - macOS:活动监视器中结束
Code Helper和Electron相关进程 - Linux:终端执行
pkill -f "Code Helper\|Electron" - 改完再启动 VS Code,不要用管理员/Root 权限——这反而会因 UAC 或权限隔离导致写入被拒
为什么 Configure Display Language 命令有时不生效
这个命令本质就是自动生成 locale.json。它失效通常意味着底层条件不满足:
- 没装 Microsoft 官方语言包:
ms-ceintl.vscode-language-pack-zh-hans(发布者必须是 Microsoft,别信“Chinese Menu”之类第三方) - VS Code 版本低于 1.70(旧版才读
settings.json中的locale字段;新版已弃用) - 当前工作区或远程环境(SSH / Dev Container)下有独立的
locale.json或.vscode/settings.json覆盖了用户级设置 - 目录权限异常(尤其 WSL 或曾用
sudo code启动过),导致 VS Code 无法写入该文件
locale.json 生效后仍部分英文?这是正常现象
VS Code 官方汉化只覆盖核心 UI:顶部菜单栏、左侧活动栏 hover 文字、命令面板(Ctrl+Shift+P)、设置界面(Ctrl+,)。以下部分**天生不走 locale 配置**,不是配置失败:
- 集成终端(Terminal)里的命令输出、Git 提示、Shell 报错——它们由系统 Shell 或 Git 自身决定语言
- 调试控制台(Debug Console)和部分插件弹窗(如 Live Server 通知)——依赖插件自身是否提供中文资源
- 右键菜单中的部分条目——部分由操作系统或 Shell 提供,VS Code 不控制
真正要盯的是命令面板里搜 locale 看值是否为 zh-cn,以及菜单栏文字是否变中文——这两处对了,locale.json 就算成功生效。其他地方的英文,得单独查对应组件的语言支持机制。


















