vs code 中文失效的最常见原因是装错第三方插件,唯一可靠的是微软官方语言包 ms-ceintl.vscode-language-pack-zh-hans,需精确搜索安装、点击 restart now 重启,并确保 locale.json 内容为 {"locale":"zh-cn"} 且彻底关闭进程后重开。

装错插件是中文失效的最常见原因
搜“中文”“汉化”“zh-cn”大概率装到第三方插件,比如 Chinese Language Pack 或 VSCode Chinese,它们不维护、不更新,甚至弹广告或改主页。VS Code 界面不会因为你装了个名字带“中文”的插件就自动变中文。
唯一可靠的只有微软官方语言包:ms-ceintl.vscode-language-pack-zh-hans,发布者必须是 Microsoft,图标带蓝勾认证。
- 在扩展面板(
Ctrl+Shift+X)里精确搜索Chinese (Simplified) Language Pack for Visual Studio Code(注意大小写和空格) - 安装后右下角会弹
Restart Now—— 必须点它;Reload Window不生效 - 装完若没弹提示,基本等于没装成功,重试前先检查网络是否能访问 VS Code 扩展市场
Configure Display Language 命令没反应?说明语言包根本没装上
这个命令本质是往 locale.json 写入 {"locale":"zh-cn"}。如果按 Ctrl+Shift+P 输入 Configure Display Language 后列表为空、没响应、或选了 zh-cn 但界面仍是英文,90% 是语言包没装成功,或装完没重启。
- 验证方式:执行
Extensions: Show Installed Extensions,确认ms-ceintl.vscode-language-pack-zh-hans在列表中且状态为Enabled - 如果插件存在但禁用,手动启用后再试命令
- 如果插件不在列表里,卸载所有疑似中文插件,再重新安装官方包
locale.json 手动设置是绕过 UI 失效的兜底方案
当公司内网无法访问扩展市场、命令面板打不开、或反复切换失败时,直接编辑配置文件是最稳的方式。
locale.json 路径:
- Windows:
%APPDATA%\Code\locale.json - macOS:
~/Library/Application Support/Code/locale.json - Linux:
~/.config/Code/locale.json
内容必须严格为:
{"locale":"zh-cn"}
注意:zh_CN、zh-CN、ZH-CN 都无效;保存后必须彻底关闭所有 VS Code 进程(Windows 查任务管理器里的 Code.exe,macOS 用 Activity Monitor 查 Electron),再启动。
菜单/终端/调试界面仍是英文?不是设置问题,是模块独立性导致的
VS Code 的主界面、右键菜单、集成终端、调试控制台使用的是不同本地化上下文。即使 locale.json 正确,这些区域仍可能显示英文。
- 终端/调试英文:执行
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans(注意 ID 全大写),强制刷新语言包依赖项 - 右键菜单汉化不全:官方汉化覆盖率约 85%,可补装社区插件
Chinese Menu或vscode-zh-hans-menu - 设置页搜索框里搜
locale,确认值确实是"zh-cn";别误看成settings.json里的其他字段
最关键的细节永远是:语言包只是字典,locale.json 是开关,而彻底重启才是让开关咬合的那一下机械动作——少一个环节,中文就卡在加载途中。











