必须用官方MS-CEINTL.vscode-language-pack-zh-hans的.vsix文件,通过命令面板执行“Extensions: Install from VSIX”安装,再运行“Configure Display Language”设为"zh-cn"并彻底重启;双击或拖拽.vsix无效,且locale必须为小写连字符格式。

离线状态下 VSCode 无法自动下载中文语言包,必须用官方 MS-CEINTL.vscode-language-pack-zh-hans 的 .vsix 文件手动安装,且安装后必须执行 Configure Display Language 并设为 "zh-cn",否则界面仍为英文。
怎么下载真正能用的中文语言包
不是搜“VSCode 汉化包”点网盘链接,而是认准唯一发布者:MS-CEINTL。其他名字相似的插件(比如发布者是个人 ID 或叫 chinese-language-pack)基本无效。
- 打开官网扩展页:https://www.php.cn/link/60f79dfd80ed019c1c155704b89568bc
- 拉到页面最底部,点 Download Extension —— 下载文件名形如
MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix - 右键解压该
.vsix(本质是 zip),打开package.json,确认"engines": {"vscode": "^1.104.0"}与你本地code --version输出的主版本号一致(例如输出1.104.2就匹配) - 别用百度搜出的压缩包、exe 封装器或第三方镜像站——过期率高,还可能带静默行为
为什么双击或拖拽 .vsix 文件不生效
VSCode 自 1.70 起已禁用双击/拖拽安装方式,会静默失败且无提示。它只是把文件复制进 ~/.vscode/extensions/ 目录,但没注册、没激活、没触发语言资源加载逻辑。
- 正确路径:按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 → 在弹出框中选中文件 → 点Install - 安装完成后,VSCode 不会自动切语言,必须再执行一次
Configure Display Language命令并选zh-cn - 如果跳过这步,状态栏右下角仍显示
en,设置页、命令面板、调试面板全英文
locale 配置写成 zh-hans 还是 zh-cn
必须写 "zh-cn",不是拼写偏好问题,而是 VSCode 内部语言协商机制决定的。
- 官方语言包 ID 是
ms-ceintl.vscode-language-pack-zh-hans,但 VSCode 主程序默认只认zh-cn作为简体中文的“显示语言标识” - 写
zh-hans在某些版本(如 1.95+)会导致部分 UI(设置页、调试面板)仍为英文 -
settings.json中不要手动写死"locale": "en",删掉这行;VSCode 会 fallback 到系统语言 + 已安装语言包 - Windows 上若系统区域设为“英语(美国)”且勾选了 “Beta: Use Unicode UTF-8”,可能跳过语言包;macOS/Linux 下检查
LANG是否为en_US.UTF-8类值
安装后重启仍不生效的隐藏原因
常见但容易被忽略的三点:启动方式错、后台进程残留、企业策略拦截。
- 你双击的可能是旧版快捷方式(指向老路径),实际启动的是未更新的 VS Code 实例;建议从开始菜单或应用坞里重新打开
- 安装后没彻底终止后台进程:Windows 可在任务管理器中结束所有
Code.exe进程;macOS/Linux 运行pkill -f 'code' - 某些内网安全组策略会禁用
file://协议,导致本地扩展加载失败——此时需联系 IT 部门临时放行或换物理机操作
最易被跳过的动作是:安装 .vsix 后忘记运行 Configure Display Language,以及没清干净旧进程就重启。这两个步骤缺一不可,且顺序不能颠倒。


















