离线安装VS Code中文包失败的主因是引擎版本不匹配和locale.json配置错误:需修改vsix中package.json的engines.vscode为本地精确版本,确保locale.json路径正确且值为"zh-cn",并用命令面板安装后彻底重启。

为什么离线装中文包会报“签名无效”或卡在安装中
VS Code 1.85+ 默认启用扩展签名验证,离线环境下无法联网校验 .vsix 内嵌证书链,直接静默失败——不是你下载的包坏了,也不是系统时间不对,而是 VS Code 根本没机会连微软的 timestamp server 或 CRL 服务。常见现象包括:点击 Install 后进度条不动、命令面板无响应、扩展列表里找不到已选包、ms-ceintl.vscode-language-pack-zh-hans 显示 “Install failed” 但无具体错误。
必须改 package.json 里的 engines.vscode
报错本质不是签名问题,是兼容性声明拦截:package.json 中的 "engines": {"vscode": "^1.90.0"} 和你本地 code --version 输出(如 1.96.3)不满足语义化匹配规则。VS Code 拒绝加载,连签名校验那步都跳过了。
- 用
unzip -l your.vsix确认根目录含extension/package.json - 解压该文件(别用 Windows 资源管理器双击,会破坏 ZIP 结构)
- 编辑
extension/package.json,把"engines": {"vscode": "^1.90.0"}改成"engines": {"vscode": "1.96.3"}(填你本地完整版本号) - 重新打包为 ZIP,再把后缀改为
.vsix(注意:是重打包,不是重命名)
装完还是英文?检查 locale.json 的写法和路径
语言包装成功 ≠ 界面变中文。VS Code 必须同时加载语言资源 + 识别 locale.json 配置 + 彻底重启进程。最容易漏的是值写错或路径不对。
-
"locale": "zh-cn"必须小写、短横线、双引号包裹;zh_CN、zh-hans、Chinese全部无效 - Linux 路径:
~/.config/Code/User/locale.json - Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
~/Library/Application Support/Code/User/locale.json
别信双击安装或拖拽,用命令面板走 Extensions: Install from VSIX
VS Code 自 1.70 起已禁用双击 .vsix 安装方式,不报错也不生效;图形界面拖拽在离线时依赖后台网络调度,常挂起或丢弃操作。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Extensions: Install from VSIX,回车 - 选择你修改并重打包后的
.vsix文件 - 安装完成后,必须彻底退出所有 VS Code 进程(包括系统托盘),再重新启动
locale.json、走命令面板安装——这三步缺一不可。任何一步跳过,都会导致“明明装了却还是英文”的情况。


















