VS Code 中文界面需同时安装微软官方中文语言包、执行 Configure Display Language 命令设 locale 为 "zh-cn"、并彻底重启进程;仅装插件或仅重载窗口无效。

VSCode 中文界面不是装个插件就完事——必须同时满足三个条件:安装 Microsoft 官方 ms-ceintl.vscode-language-pack-zh-hans 插件、通过 Configure Display Language 命令把 locale.json 设为 "zh-cn"、彻底关闭所有 VS Code 进程后重新启动。缺任一环,都会出现菜单中文但设置页英文、右下角语言代码不显示、或重启后还原成英文等现象。
怎么确认装的是官方中文语言包?
别搜“中文插件”或“汉化”,直接在扩展面板(Ctrl+Shift+X)输入完整名称:Chinese (Simplified) Language Pack for Visual Studio Code。重点核对两点:
- 发布者必须是
Microsoft,不是Chinese Language Pack或其他仿名插件 - 插件 ID 必须是
ms-ceintl.vscode-language-pack-zh-hans(可在扩展详情页 URL 或@installed搜索结果中看到) - 安装完成后右下角会弹出
Change Language and Restart提示——点它,别忽略
Configure Display Language 命令没反应或选不了 zh-cn?
这不是命令失效,而是前置条件没到位。常见真实原因:
-
locale.json文件根本不存在:VS Code 不会自动创建它,需手动建立(路径见下条) - 插件未真正启用:在扩展面板搜
@installed,确认该插件状态为Installed且未被禁用 - 工作区
.vscode/settings.json里写了"locale": "en"等错误值——它不会生效,但可能干扰命令面板加载
更稳的做法:按 Ctrl+Shift+P → Open User Settings (JSON),在里面加一行:"locale": "zh-cn"(注意双引号、小写、短横线),保存后执行 Configure Display Language 再选 zh-cn。
locale.json 路径和内容必须严格匹配
这个文件不存于 settings.json,而是一个独立配置:
- Windows:
%USERPROFILE%\AppData\Roaming\Code\User\locale.json - macOS:
~/.vscode/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容只允许一行合法 JSON:{"locale": "zh-cn"}。不能多空格、不能用单引号、不能写成 zh_CN 或 zh-hans(1.80+ 版本已废弃后者)。改完必须关掉所有窗口,检查任务管理器(Windows)或活动监视器(macOS)里是否还有 Code.exe 或 Electron 进程残留,再全新启动。
网页版 code-server 或远程 SSH 能用中文吗?
可以,但配置方式不同:它不读取本地 locale.json,而是依赖服务端用户目录下的同名文件。例如在 Linux 远程虚拟机中,需运行:
echo '{"locale": "zh-cn"}' > ~/.config/Code/User/locale.json
然后刷新浏览器页面。注意:code-server 不支持部分桌面端扩展,若安装时提示 The 'xxx' extension is not available in code-server for the Web,说明该扩展无法在网页环境运行,和语言包无关。
最容易被忽略的其实是“彻底重启”——很多人点了 Reload Window 就以为好了,但 locale.json 只在进程启动时读取一次。哪怕只留一个后台窗口没关,新启动的实例也会继承旧语言环境。


















