【终极解决】VSCode 1.97.2 无法安装 ASM Code Lens 2.6.13 版本不兼容问题（附改包教程）

一、问题背景

最近在使用 VSCode 1.97.2 搭建汇编开发环境时，安装热门汇编插件 maziac.asm-code-lens 遇到致命兼容性问题：

安装新版 2.6.13 ：提示 版本不适配、引擎版本不满足，无法安装
安装经典稳定版 1.10.2 ：微软官方市场已下架，API 404 Resource not found
GitHub 源码仓库已被作者删除，无法自行拉取源码打包

问题卡在：新版装不上、旧版找不到、源码无渠道、内网离线安装报错。仅实践100% 可行的手动改包破除版本限制方案，适配VSCode 1.97.2版本。

二、报错根本原因

ASM Code Lens 在 2.6.12 及以上新版本 重新打包发布，作者修改了插件内置的版本校验规则：

插件 package.json 中强制限定了更高的 VSCode 最低运行版本，而 1.97.2 低于插件要求的引擎版本，因此 VSCode 会直接拦截安装，判定为不兼容。

简单说：不是 VSCode 太旧，是新版插件人为锁死了低版本编辑器。

三、核心原理：VSIX 插件可手动改包

VSCode 的 .vsix 插件安装包，本质是 zip 压缩包格式。

插件的所有配置、版本兼容规则、功能定义，全部写在压缩包内的 package.json 文件中。

我们只需要手动修改该文件中的 引擎版本限制字段 ，即可 强制让任意版本 VSCode 安装任意插件，彻底解除版本校验拦截。

四、详细改包实操教程（通用所有VSIX插件）

本教程以 asm-code-lens 2.6.13 为例，适配 VSCode 1.97.2，其他插件版本不兼容问题可通用此方法。

步骤1：获取 VSIX 安装包

优先下载 2.6.13 官方包（官方未下架，仅版本锁死），或 1.10.2 归档包：

新版2.6.13官方链接（有效无404）：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/maziac/vsextensions/asm-code-lens/2.6.13/vspackage
旧版1.10.2归档地址：https://www.vsixhub.com/vsix/104675/

步骤2：解压VSIX安装包

将下载好的 xxx.vsix 文件，后缀直接改为 .zip(或者我选择直接打开压缩包中文件修改)
使用解压软件（WinRAR/7Z/系统自带解压）完整解压所有文件
进入解压目录，找到 extension 文件夹（核心插件目录）

步骤3：修改版本兼容配置（关键步骤）

打开 extension 文件夹，找到 package.json 配置文件
搜索关键字 engines，找到默认的版本限制代码

原新版插件默认限制（导致1.97.2安装失败）：

"engines": { "vscode": "^1.98.0" }

该配置含义：仅支持 1.98.0及以上 VSCode，1.97.2 直接被拦截。

两种修改方案，任选其一即可：

方案1：精准适配当前VSCode版本（成功）

"engines": { "vscode": "^1.97.2" }

尝试方案2（失败）：

"engines": { "vscode": "*" }

修改后保存文件，无任何格式错误即可。

步骤4：重新打包VSIX文件`(或者直接打开压缩包中文件修改无需这一步)`

全选解压后的所有文件，重新压缩为 zip压缩包
将压缩包后缀从 .zip 改回 .vsix
得到 已破解版本限制、适配1.97.2 的可用插件包

步骤5：vscode插件安装

方案1：

打开 VS Code，点击左侧边栏图标：扩展（Extensions） ，图标是四个方块。快捷键：Ctrl+Shift+X。
在扩展页面的右上角，点击三个小点 ⋯（更多选项）。
在弹出的下拉菜单里，选择： 从 VSIX 安装... (Install from VSIX...)
在弹出的文件选择窗口，选中修改好的 asm-code-lens-2.6.13.vsix 文件。
等待进度条走完，弹出安装成功提示；完全关闭 VS Code，重新打开软件，插件才会加载生效。

方案2：

打开终端（CMD/MINGW64），进入文件所在目录，执行强制安装命令，跳过残留校验：

code --install-extension asm-code-lens-2.6.13.vsix --force

安装完成后 重启VSCode，插件正常生效，代码镜头、汇编跳转、符号提示功能全部正常使用。