必须解压.vsix、修改extension/package.json中engines.vscode字段（如改为">=1.85.0"）、用合规zip工具重打包并改后缀为.vsix，再通过命令面板安装；注意需包含[content_types].xml、避免系统压缩工具、确保vscode进程已退出。

直接解压修改 package.json 再重打包

.vsix 就是 ZIP 包，用 7-Zip、The Unarchiver 或 unzip 都能打开。真正要改的只有根目录下那个 package.json 文件——它控制插件兼容性、ID、版本等核心行为。

• 修改前先确认当前 VS Code 版本：code --version 输出第一行（如 1.85.2）
• 打开 .vsix，找到 extension/package.json（注意不是根目录的 package.json）
• 编辑 engines.vscode 字段，例如从 "^1.90.0" 改成 "^1.85.0" 或更宽泛的 =1.85.0
• 保存后用压缩工具重新打包为 ZIP，再把后缀改成 .vsix（Windows 下需关掉“隐藏已知文件类型扩展名”才看得见）
• 不要用系统自带的“发送到 → 压缩文件夹”，它不遵循 OPC 规范，VS Code 会拒认

engines.vscode 改太宽可能触发运行时异常

放宽版本限制只是让安装通过，不代表功能完全可用。比如 Python 插件 v2024.6.0 依赖 VS Code 1.90+ 新增的 notebook.cellKind API，你在 1.85 上强行装，打开 .py notebook 时会直接报错或白屏。

• 优先查插件 GitHub 的 CHANGELOG.md 或 release note，看它是否明确标注了最低支持版本
• 如果插件用了新 API，仅改 engines.vscode 是治标不治本，得同步降级插件本身（去 Version History 找旧版 .vsix）
• 某些插件（如 volarjs.volar）还带 native 二进制，它们的架构（darwin-arm64 vs win32-x64）和 VS Code 运行时必须严格一致，这个改不了

命令行重打包时容易漏掉 [Content_Types].xml

VSIX 要求 ZIP 根目录必须包含 [Content_Types].xml，这是 OPC 规范强制项。很多 GUI 压缩工具默认不生成它，导致重打包后 code --install-extension 静默失败或报 Invalid VSIX package。

• Linux/macOS 推荐用命令行重建：

  unzip -q plugin.vsix -d tmp && cd tmp && zip -r ../plugin-fixed.vsix . -x "*.DS_Store"

• Windows 下用 PowerShell：

  Compress-Archive -Path .\tmp* -DestinationPath .\plugin-fixed.vsix -Force

  不行，它不加 [Content_Types].xml；必须用 7-Zip 命令行：

  7z a -tzip plugin-fixed.vsix -r .\tmp* -xr!__MACOSX

改完别急着装，先验证签名绕过和进程状态

即使 .vsix 本身合法，离线安装仍卡在三处：

• 必须加 --allow-unverified 参数，否则 INVALID_SIGNATURE 报错（离线环境无法连微软证书服务器）
• 安装前确保所有 VS Code 进程已退出，包括托盘里的后台服务（Windows 用 taskkill /f /im Code.exe，macOS 用 killall -u $USER 'Code Helper'）
• 路径不能含中文或空格，哪怕加了引号也建议用纯英文路径，例如 C:/vsix/plugin-fixed.vsix

最常被忽略的一点：改完 package.json 后，如果插件带语言服务器（LSP），它依然会在首次启用时尝试联网下载 server 二进制——这步离线必然失败。必须在有网机器上完整触发一次，再把整个 ~/.vscode/extensions/{id}-x.x.x/ 目录拷过去。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载