必须用Extensions: Install from VSIX命令安装中文包,双击或拖拽.vsix无效——VS Code自1.70起禁用该机制,仅复制文件而不注册扩展、不加载资源,导致右下角仍显示en、界面全英文;安装后须执行Configure Display Language选zh-cn并彻底重启。

VSCode 从本地文件安装中文包,必须用 Extensions: Install from VSIX 命令,双击或拖拽 .vsix 文件无效——这是自 VS Code 1.70 起的硬性限制,不是操作失误,而是设计如此。
为什么双击 .vsix 文件不生效
VS Code 已彻底禁用文件系统级的自动安装机制。拖入窗口或双击只会把文件复制进 ~/.vscode/extensions/ 目录,但不会注册为已启用扩展,也不会触发语言资源加载。现象是:右下角状态栏仍显示 en,设置页、命令面板全英文,重启多次无变化。
- 根本原因是扩展未进入 VS Code 的激活生命周期,只是静态存档
- 没有错误提示,静默失败,极易误判为“装好了”
- 尤其在离线环境,这个坑踩中后会浪费大量排查时间
正确安装步骤(离线必备)
确保你已从微软官方渠道下载到有效的 vscode-language-pack-zh-hans-*.vsix 文件(发布者必须是 MS-CEINTL,ID 为 ms-ceintl.vscode-language-pack-zh-hans):
- 启动 VS Code,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Extensions: Install from VSIX,回车 - 在弹出的文件选择框中,定位并选中你的
.vsix文件,点击Install - 安装完成后,**必须立刻执行
Configure Display Language并选zh-cn,再点提示中的Restart**
装完还是英文?检查这三个点
即使 .vsix 安装成功,界面仍为英文,大概率卡在这三处:
-
locale.json文件没生成或路径错:它必须位于用户级配置路径(如 Windows 是%APPDATA%\Code\User\locale.json),内容仅一行:{"locale":"zh-cn"}(小写、连字符、UTF-8 无 BOM) - 后台进程残留:Windows 查任务管理器中是否还有
Code.exe,macOS 查 Activity Monitor 中的Electron,Linux 用pkill code;不杀净,新启动仍读旧状态 - 值写错:
zh_CN、zh-hans、ZH-CN、Chinese全部无效,VS Code 只认严格符合 BCP 47 的zh-cn
最稳的兜底动作是:关死所有进程 → 手动创建 locale.json → 写入正确内容 → 全新启动。离线部署时,别依赖 UI 提示,直接改文件反而更快。


















