直接修改.vsix中extension/package.json的engines.vscode字段可快速解决中文包兼容问题,需同步配置locale.json为{"locale":"zh-cn"}并彻底重启VS Code。

直接改 .vsix 里的 engines.vscode 字段,5 分钟内能装上,不用降 VSCode、也不用翻旧包。
确认是不是版本不匹配导致的失败
错误信息里明确出现 Unable to install extension 'ms-ceintl.vscode-language-pack-zh-hans' 和 not compatible with VS Code '1.xxx' 就是它。这不是网络问题、权限问题,也不是杀毒软件拦截——VS Code 启动时直接跳过加载,连日志都不写。
- 插件在扩展面板里显示为灰色,右上角带
Disable标识 - 点开详情页顶部写着
Disabled due to incompatible version - 双击安装、拖入窗口、
code --install-extension命令全无效,且无报错提示
解压修改 extension/package.json 是最快路径
中文包本质是 ZIP,.vsix 只是后缀马甲。必须进到 extension/ 子目录下改配置,改错位置(比如根目录的 package.json)完全没用。
- 用
7-Zip(Windows)、unzip(Linux/macOS)打开下载好的ms-ceintl.vscode-language-pack-zh-hans-*.vsix - 进入
extension/package.json,找到"engines": { "vscode": "^1.90.0" }这行 - 改成你本地实际版本能接受的范围,例如:
"vscode": ">=1.85.0"(兼容宽)或"vscode": "1.96.3"(填code --version输出的完整版本号) - 保存后,用同一工具把整个文件夹重新打包为 ZIP,再把后缀名改回
.vsix
装完还是英文?重点检查 locale.json 路径和值
插件只是“翻译素材库”,VS Code 不会自动启用它。真正起效的是 locale.json 文件,而且只认 "zh-cn" 这个值,zh-hans、zh_CN、Chinese 全部无效。
- 路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容必须严格是:
{"locale":"zh-cn"}(小写、短横线、双引号、UTF-8 无 BOM) - 改完后必须彻底退出所有 VS Code 进程(包括系统托盘里的
Code Helper),再从开始菜单/应用坞启动
别踩这些坑
很多人卡在最后一步,不是改错了字段,而是环境残留或操作顺序不对:
- 用 Windows 资源管理器双击解压再拖回去重命名 → 破坏 ZIP 结构,静默失败
- 在
settings.json里写"locale": "zh-cn"→ 完全无效,VS Code 1.70+ 只读locale.json - 点了 Restart 提示框里的 Cancel 或直接关窗口 → 后台进程还在跑,配置不重载
- 用命令面板搜 “change language” 模糊匹配 → 找不到正确命令,必须输全
Configure Display Language
最常被忽略的是:改完 engines.vscode 后没清缓存,或者 locale.json 被工作区设置或 Remote-SSH 插件覆盖。如果重启后仍无效,先删掉 %APPDATA%\Code\Cache(Windows)或对应平台缓存目录,再试一次。


















