离线安装vscode中文语言包后,必须先在扩展面板搜索ms-ceintl.vscode-language-pack-zh-hans并确认状态为“已启用”,再检查log (window)中是否有“loaded locale zh-cn”日志,最后验证顶部菜单栏、命令面板、设置页面三处是否全中文且locale.json内容严格为{"locale":"zh-cn"}。

看扩展面板里有没有 ms-ceintl.vscode-language-pack-zh-hans 且状态为“已启用”
离线安装后第一件事不是开菜单看中文,而是确认语言包真被 VSCode 认出来了。打开扩展面板(Ctrl+Shift+X),搜索 ms-ceintl.vscode-language-pack-zh-hans —— 注意必须输全 ID,别只搜 “chinese”。如果没出现、或显示“已禁用”、或发布者不是 MS-CEINTL,说明安装根本没注册进系统,只是文件被丢进了 ~/.vscode/extensions/ 目录而已。
常见失效表现:
- 扩展列表里完全搜不到这个 ID
- 搜到了但图标灰掉,右上角显示“已禁用”
- 名字对但发布者是第三方(比如 “VSCode Chinese” 或带“汉化补丁”字样的山寨包)
查 Log (Window) 里有没有 Loaded locale zh-cn 日志
VSCode 不报错不等于成功加载。打开输出面板(Ctrl+Shift+U),下拉选 Log (Window),然后搜索关键词 zh-cn 或 localization:
- 看到
Loaded locale zh-cn from ...→ 表示资源加载成功 - 看到
Failed to load localization或路径为空 → 说明 .vsix 解压失败、文件损坏,或被杀毒软件拦截 - 完全搜不到任何相关日志 → 插件压根没进入加载流程,大概率是安装方式错误(比如双击 .vsix)或版本不匹配
验证三处核心 UI 是否真变中文
别信右下角提示、终端输出或 Git 面板——它们不走 locale 配置。只盯这三处:
- 顶部菜单栏:
文件、编辑、视图、终端等是否为中文 - 命令面板(
Ctrl+Shift+P):输入Configure Display Language能否高亮匹配,且选项里有zh-cn - 设置页面(
Ctrl+,):搜索locale,看字段值是否显示为"zh-cn"(注意小写、短横线)
只要这三处全中文,才算真正生效。其他区域(如调试控制台、Git 提示、终端命令输出)默认英文属正常,和语言包无关。
检查 locale.json 文件是否存在且内容严格正确
这是最常被跳过的一步。VSCode 只认这个文件,不认 settings.json 里的 locale 字段。路径和内容必须同时满足:
- 路径必须是用户级配置:
Linux:~/.config/Code/User/locale.json
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json - 文件内容只能是这一行:
{"locale":"zh-cn"}(小写、短横线、双引号、UTF-8 无 BOM 编码) - 不能是
zh_CN、zh-hans、Chinese、"zh-cn "(尾部空格)、或带注释的 JSON
文件存在但界面仍英文?先用任务管理器(Windows)或活动监视器(macOS)杀掉所有 Code.exe 或 Electron 进程,再重启 VSCode —— 后台残留进程会复用旧 locale 环境。











