离线vscode中文语言包无法自动更新,必须手动卸载旧包并安装新包;更新前需确认vscode版本与语言包engines.vscode字段匹配,且安装后须执行configure display language选择zh-cn并重启。

离线语言包不能自动更新,必须手动替换
VSCode 的离线安装语言包(.vsix)一旦装入,就不会出现在「已安装扩展」列表里触发自动更新,也不会响应 Check for Updates。它本质上是被当作“内置本地化资源”加载的,不是常规扩展。所以不存在“点一下更新”的路径——更新 = 卸载旧包 + 安装新包。
确认当前语言包版本与 VSCode 版本是否匹配
离线语言包更新失败最常见的原因是版本错配。VSCode 1.92 要求语言包 engines.vscode 字段至少为 ^1.92.0,否则 code --install-extension 会直接拒绝安装,报错类似:Extension 'MS-CEINTL.vscode-language-pack-zh-hans-1.91.2024070509.vsix' is not compatible with Code '1.92.2'。
- 查当前 VSCode 版本:启动后左下角点击版本号,或运行
code --version - 查已安装语言包版本:打开
%USERPROFILE%\.vscode\extensions(Windows)或~/.vscode/extensions(macOS/Linux),找以ms-ceintl.vscode-language-pack-zh-hans-开头的文件夹,进其package.json查engines.vscode - 下载新包时,务必去官方市场页面(如 Chinese (Simplified) Language Pack),在右侧 Resources 区点击
Download Extension—— 这个链接带签名且绑定版本,比第三方镜像或 GitHub Release 更可靠
code --install-extension 失败的三个关键卡点
即使下载了正确版本的 .vsix,命令行安装仍可能静默失败或报错。重点排查以下三点:
-
code命令不可用?不是 PATH 问题,而是没启用 Shell Command:按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 报错
INVALID_SIGNATURE?离线环境无法校验证书链,加参数重试:code --install-extension vscode-language-pack-zh-hans-1.92.2024080709.vsix --allow-unverified - 安装提示 success 但界面仍是英文?重启 VSCode 后,再按
Ctrl+Shift+P→ 输入Configure Display Language→ 选择zh-cn→ 确认并重启(这步漏掉,语言包不会生效)
最稳的批量/内网更新方案:复制 extensions 文件夹
在企业内网或需统一部署多台机器时,手动下载 + 命令行安装容易出错。更可靠的做法是:
- 在一台联网、VSCode 版本和目标机一致的机器上,用官方方式安装好最新语言包
- 进入该机的
.vscode\extensions目录,找到完整语言包文件夹(如ms-ceintl.vscode-language-pack-zh-hans-1.92.2024080709) - 将整个文件夹(含
package.json、language-pack子目录等全部内容)拷贝到目标机对应路径下 - 重启 VSCode,再执行
Configure Display Language切换即可
这个方法绕过了签名验证、版本字段解析、命令行 PATH 等所有中间环节,本质是复用已通过 VSCode 加载验证的运行时结构 —— 尤其适合老旧系统或策略限制严格的环境。











