答案是插件元数据中engines.vscode字段与vs code版本不匹配,需修改该字段或安装对应历史版本.vsix包;安装后还需在settings.json中设置"locale": "zh-cn"并重启。

VSCode 汉化包(ms-ceintl.vscode-language-pack-zh-hans)报 “not compatible with VS Code '1.81.1'” 这类错误,**不是 VSCode 本身要降级,而是插件的 engines.vscode 字段锁死了支持范围**。直接删掉重装最新版没用,得改兼容声明或装旧版 .vsix。
怎么确认是汉化包版本不匹配?
错误信息里明确带 Unable to install extension 'ms-ceintl.vscode-language-pack-zh-hans' as it is not compatible with VS Code 'x.x.x',就是典型引擎不匹配;插件在 Extensions 面板里显示为灰色、右上角有 Disable 标识,点开详情页顶部也写明 “Disabled due to incompatible version”。别急着卸载 VSCode——这问题 95% 出在插件元数据上。
手动修改 .vsix 中的 engines.vscode
离线安装时被拒,是因为 .vsix 包里的 package.json 校验失败。它本质是 zip,可解包修改:
- 用
7-Zip(Windows)、Archive Utility(macOS)或unzip(Linux)打开下载好的.vsix文件 - 进入
extension/package.json(注意:不是根目录那个,是extension/子目录下的) - 找到
"engines": { "vscode": "^1.84.0" }这行,改成你当前 VSCode 版本能接受的范围,例如:"^1.78.0 || ^1.81.0"或更宽泛的">=1.78.0" - 保存后重新打包为 zip,再把后缀名改回
.vsix - 在 VSCode 中执行
Extensions: Install from VSIX命令安装
从 Marketplace 安装旧版汉化包(推荐优先试)
比改 .vsix 更安全省事:打开扩展面板,搜 Chinese (Simplified) Language Pack,点击右下角 ⋯ → Install Another Version…,选一个和你 code --version 匹配的历史版本(比如你用的是 1.81.1,就选 1.81.x 分支的)。这个操作保留签名验证,也不需要解包。
如果该菜单项灰显,说明微软没发布那个版本的公开历史包——此时才需走 .vsix 修改路线。
安装后仍不生效?重点检查两处
改完或重装后重启 VSCode 还是英文界面,大概率卡在这两个地方:
-
settings.json里是否设置了"locale": "zh-cn"?没有就加上,这是触发汉化的核心开关 - 是否误启用了其他语言包插件(如
rokoroku.vscode-theme-onedark自带简中翻译)?它们可能覆盖 locale 行为,临时禁用排查
汉化包本身不提供 UI 功能,只做资源映射,所以不会报错也不会崩溃——失效时往往静默,只留英文界面这个唯一线索。











