VSCode中文界面需同时满足三条件:安装微软官方中文语言包(ID ms-ceintl.vscode-language-pack-zh-hans)、执行Configure Display Language命令将locale设为"zh-cn"、彻底重启进程(非Reload Window)。

VSCode 设置中文界面不是“装个插件就完事”,而是三要素闭环:装对插件 + 用对命令 + 彻底重启。漏掉任意一环,右下角永远显示 en,菜单和设置项也始终是英文。
安装 Chinese (Simplified) Language Pack 插件必须认准 Microsoft 官方 ID
第三方插件名字带“汉化”“中文菜单”“Pro”“Ultimate”的一律跳过——它们不更新、不兼容,有的还会导致 Cannot read property 'translate' of undefined 报错或命令面板乱码。唯一有效的扩展是:
名称:Chinese (Simplified) Language Pack for Visual Studio Code
发布者:Microsoft
扩展 ID:ms-ceintl.vscode-language-pack-zh-hans
在扩展面板(Ctrl+Shift+X)中粘贴完整名称搜索,只点这个带蓝勾认证图标的安装。装完右下角会弹 Restart Now,此时别关窗口,先别点——等下一步命令执行完再统一重启。
Configure Display Language 命令只接受 zh-cn,其他写法全无效
这个命令才是真正写入语言配置的入口,它会自动生成或覆盖 locale.json 文件。但注意:
-
zh、zh_CN、zh-hans、Chinese (Simplified)都不会被识别,选了也没反应,且无任何错误提示 - 输入
Configure Language或Configure UI Language是错的,正确命令名是Configure Display Language - 执行后弹出列表里只有
zh-cn这一项对应简体中文,别选错成zh-tw或en
选完立刻弹出提示:“需要重启窗口以应用更改”。这里的关键是:必须点 Restart,而不是 Developer: Reload Window——后者只是刷新 UI,完全不重新加载语言配置。
手动编辑 locale.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"}
- 不能加注释
- 不能用单引号
- 不能有多余空格或换行
- 编码必须为 UTF-8 无 BOM(用 VSCode 自己打开编辑可避免)
改完保存后,必须彻底退出 VS Code:Windows 查任务管理器杀掉所有 Code.exe 进程;macOS 在活动监视器中结束全部 Electron 相关进程;Linux 运行 pkill -f 'code'。残留的 helper 进程会继续读旧缓存。
验证是否真生效,只看这三处,别被终端骗了
很多用户看到终端还是英文,就以为汉化失败。其实这是正常现象——终端、调试控制台、Git 输出、部分插件界面走的是系统或 shell 的本地化逻辑,和 VS Code 主界面的 locale 无关。
真正判断是否成功,只盯以下三处:
- 顶部菜单栏:
文件/编辑/视图是否为中文 - 命令面板:
Ctrl+Shift+P打开后,输入框上方是否显示请输入命令或搜索设置 - 设置界面:
Ctrl+,打开后,左侧导航栏是否为用户/工作区/扩展
Remote-SSH 或 WSL 下仍是英文?那是远程实例没配,得去远程机器的 ~/.vscode-server/data/Machine/xxx/locale.json 单独写一遍。本地设对了,远程没动,自然还是英文。


















