VSCode菜单栏仍英文最常见原因是装了非官方插件;必须安装Microsoft官方中文语言包(ID:ms-ceintl.vscode-language-pack-zh-hans),再执行Configure Display Language命令选zh-cn并彻底重启,或手动创建合法locale.json文件置于正确路径。

装错插件是菜单栏仍英文的最常见原因
菜单栏没变中文,90% 是因为装了非官方插件。VS Code 只认 ms-ceintl.vscode-language-pack-zh-hans 这个扩展 ID,发布者必须是 Microsoft。搜“中文”“Chinese Menu”“VSCode Chinese”点安装的,基本都失效或引发 Cannot read property 'translate' of undefined 报错。
正确做法:
- 按
Ctrl+Shift+X打开扩展面板,严格粘贴全名搜索:Chinese (Simplified) Language Pack for Visual Studio Code - 确认作者图标带蓝白 VS 标志 + 中文“中”字
- 安装后右下角弹窗必须点
Change and Restart—— 点Reload Window不生效
Configure Display Language 命令必须执行且选对值
插件只是“字典”,真正调用字典的是 Configure Display Language 命令。它会写入 locale.json,不是改 settings.json(1.70+ 版本已废弃该字段)。
操作要点:
- 按
Ctrl+Shift+P输入Configure Display Language(不能少字母、不能大小写错) - 从下拉列表中**只选
zh-cn** ——zh-CN、Chinese (Simplified)、zh-hans都无效 - 点
Restart,不是重载:Windows 查任务管理器确认所有Code.exe进程已退出;macOS/Linux 用pkill -f "Code Helper"
手动写 locale.json 是最稳的兜底方式
命令面板打不开、列表没 zh-cn、或反复失败时,直接编辑配置文件绕过 UI 层。路径和格式错一个字符就白干。
必须满足三项:
-
路径准确:
%APPDATA%\Code\User\locale.json(Win)、~/Library/Application Support/Code/User/locale.json(macOS)、~/.config/Code/User/locale.json(Linux) -
内容合法:仅一行纯 JSON ——
{"locale":"zh-cn"}(双引号、小写、短横线、无空格、无注释、无尾逗号) -
重启彻底:关闭所有窗口后,再双击图标或终端执行
code启动,后台进程残留会导致配置不加载
远程开发(SSH/WSL)需单独配 locale.json
本地设好中文,连上 Remote-SSH 或 WSL 后菜单仍是英文?因为远程实例运行的是独立的 VS Code Server,它读的是远程机器上的 locale.json,不是你本地的。
解决方法:
- 连上远程后,在终端执行
code --list-extensions确认 Server 已就绪 - 进入远程路径:
~/.vscode-server/data/Machine/(后面可能带哈希目录) - 在该目录下新建
locale.json,内容同上:{"locale":"zh-cn"} - 重启远程窗口(不是本地窗口)
真正容易被忽略的是:Python、C/C++ 等插件自身的调试面板、报错提示是否中文,跟 VS Code 主体语言无关——它们是否汉化,取决于插件自己有没有内置中文资源,装了语言包也不会自动翻。


















