真正生效的只有三件事:装对官方语言包、执行 Configure Display Language 命令选 zh-cn、彻底重启;必须安装 Microsoft 官方语言包 ms-ceintl.vscode-language-pack-zh-hans,运行命令后选带引号的 zh-cn 并点击 Restart,或手动在用户级路径下创建严格格式的 locale.json 文件。

VSCode 无法通过“常规修改办法”实现纯中文界面——所谓改 settings.json、装第三方汉化插件、点右下角状态栏切换,99% 失败。真正生效的只有三件事:装对官方语言包、执行 Configure Display Language 命令选 zh-cn、彻底重启。少一个环节,菜单就卡在半中半英状态。
必须安装 Microsoft 官方语言包,ID 是 ms-ceintl.vscode-language-pack-zh-hans
扩展面板(Ctrl+Shift+X)搜 chinese 会出来一堆名字带“汉化”“中文支持”的插件,全别点。只认准这一项:
- 名称是
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者显示为 Microsoft(带蓝勾认证)
- 扩展 ID 必须是
ms-ceintl.vscode-language-pack-zh-hans(注意大小写和连字符) - 装完右下角会弹提示,但此时界面仍是英文——这是正常现象,插件只是“备好字典”,还没激活
Configure Display Language 命令只接受 zh-cn,其他写法全无效
这个命令不是“选中文”,而是向 VS Code 发出明确指令:用简体中文资源启动。它不识别任何变体:
- 输
Configure Display Language(注意大小写和空格),不是Change Language或Set Locale - 列表里必须选带引号的
zh-cn——zh_CN、ZH-CN、zh、Chinese (Simplified)全部静默失败,且不报错 - 弹窗出现后,必须点 Restart,不是 Reload Window;后者不杀进程,语言配置根本不会重载
- 如果点了 Restart 后仍是英文,大概率是
locale.json被写到了错误路径(比如工作区下的.vscode/locale.json),VS Code 只读用户级路径
手动创建 locale.json 是最稳兜底方案
当命令面板打不开、列表没 zh-cn、或重启后仍英文,直接写配置文件最可靠,但必须满足三个硬条件:
- 先彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe,macOS 用活动监视器结束Code Helper - 定位正确路径并新建/编辑文件:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:~/Library/Application Support/Code/User/locale.json
– Linux:~/.config/Code/User/locale.json - 内容严格为一行 JSON:
{"locale":"zh-cn"}(无 BOM、无多余空格、无逗号、不能有注释)
Remote-SSH 或 WSL 下界面仍是英文?那不是本地没设好,而是远程端的 VS Code Server 没配——它读的是远程机器上的 ~/.vscode-server/data/Machine/locale.json,和本地完全无关。终端、Git 输出、调试控制台显示英文也属正常,它们的语言环境由系统或运行时决定,不是 VS Code 的翻译范围。盯住顶部菜单栏、命令面板搜索框文字、设置页左侧导航是否为中文,这三处对了,就是真汉化成功。


















