VSCode侧边栏显示英文的主因是locale.json配置错误或缺失:路径须在用户级而非工作区,内容须为{"locale":"zh-cn"}且无BOM;Remote-SSH/WSL需在远程~/.vscode-server/data/Machine/xxx/下单独配置;右键菜单需Chinese Menu插件,GitLens等扩展需单独设language。

VSCode侧边栏(如“Explorer”“Search”“Source Control”)默认由语言包控制,但locale.json没生效时,它一定显示英文——不是插件没装,而是配置路径、格式或作用域错了。
为什么 Configure Display Language 后侧边栏还是英文
这个命令本该自动生成正确的locale.json,但实际中常被绕过或覆盖:
- 你手动在
settings.json里写了"locale": "zh-cn":VS Code 1.70+ 已完全弃用该字段,静默忽略,不报错也不提示 -
locale.json被误建在工作区目录(.vscode/locale.json):它只对当前文件夹生效,且会被用户级设置覆盖 - 远程开发(Remote-SSH / WSL)下只配了本地:远程 VS Code Server 是独立进程,必须在远程机器的
~/.vscode-server/data/Machine/xxx/locale.json里单独写 - 终端启动 VS Code(如
code .)时环境变量透传:$LANG=en_US.UTF-8会强行覆盖locale.json设置
检查 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"}(注意是zh-cn,不是zh_CN或Chinese (Simplified)) - 文件不能有 BOM 头,不能是 UTF-8 with BOM 编码(用 VS Code 自带编辑器保存即可避免)
右键菜单、GitLens 等扩展面板仍是英文怎么办
这不是locale.json的问题,是设计限制:
- 侧边栏右键菜单(如“新建文件”“刷新”)属于 Electron 上下文菜单层,官方语言包不覆盖——必须装
Chinese Menu插件(ID:shengchen.vscode-chinese-menu),安装后需关闭再打开右键才刷新 - GitLens 的 SCM 面板标题、按钮文字由扩展自身控制,需在
settings.json中显式加:"gitlens.language": "zh-cn" - 其他扩展(如 Prettier、ESLint)是否汉化,取决于其是否内置 i18n 支持;查 GitHub README 或 Issues 搜
chinese或locale,别指望语言包自动兜底
Remote-SSH / WSL 下侧边栏英文的补救操作
本地设好没用,远程实例根本读不到你的用户级locale.json:
- 先用终端登录远程环境(如
ssh user@host或进入 WSL) - 执行
code --list-extensions确认 VS Code Server 正在运行 - 进入
~/.vscode-server/data/Machine/下的哈希命名子目录(如a1b2c3...),在此目录下新建locale.json - 内容仅一行:
{"locale":"zh-cn"},保存后在远程窗口中执行Developer: Reload Window
最容易被忽略的是:侧边栏里“扩展”面板本身是滚动列表,其中每个扩展的名称是否中文,取决于它是否声明了contributes.localizations并提供了zh-cn翻译资源——这和 VS Code 主体无关,也和locale.json无关,只能看扩展作者有没有做。


















