vs code插件市场不支持多版本共存，旧版可见需在marketplace url末尾添加?vscodeversion=x.x.x参数强制加载兼容版本列表，且仅带绿色✅的版本可安装；engines.vscode字段严格控制兼容性，如"^1.85.0"仅匹配1.85.x系列。
VSCode 插件市场本身不提供“多版本共存”能力，所有发布行为都是单版本覆盖式更新。所谓“多版本发布策略”，实际是插件作者在 package.json 中对 engines.vscode 字段的声明方式、历史版本保留粒度、以及是否提供预发布通道（@tag:preview）的组合选择——它直接影响用户能否安装旧版、是否被自动升级、以及内网/离线场景下能否绕过校验。
如何让旧版插件在 Marketplace 页面可见
VSCode 1.85+ 默认隐藏所有 engines.vscode 声明低于当前版本的插件版本。这不是前端 UI 隐藏，而是后端主动过滤。要强制显示历史版本列表：
- 打开插件市场页，例如
https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode - 在 URL 末尾追加
?vscodeVersion=1.79.2（必须与你本地code --version输出完全一致） - 刷新页面，右下角出现
Install Another Version…下拉菜单 - 仅选带绿色 ✅ 的版本；若整个菜单灰显，说明作者未发布该 VSCode 版本兼容的 release，需走离线路径
package.json 中 engines.vscode 的写法决定兼容边界
这个字段不是装饰，它直接控制 Marketplace 展示逻辑和本地安装校验。宽松写法能降低用户安装失败率，但可能掩盖真实兼容问题：
-
"vscode": "^1.85.0"：只允许 1.85.x 小版本升级，1.84.x 或 1.86.0 都不匹配 "vscode": ">=1.75.0 ：明确划定支持区间，适合长期维护的稳定插件-
"vscode": "=1.79.2"：精确锁定，极少用，仅用于调试或临时修复特定版本 bug - 错误写法如
"^1.85"（缺补零）或"~1.85.0"（语义错误）会导致 Marketplace 解析失败，版本不可见
预发布（preview）版本不是“测试版”，而是独立发布通道
启用 @tag:preview 后，VSCode 会从 Marketplace 拉取带 preview 标签的版本，但它与正式版共享同一插件 ID，安装即覆盖。关键点在于：
- 预发布版仍受
engines.vscode约束，若声明为^1.102.0，用户 VSCode 是 1.101.3 就装不上 - 用户需手动开启设置：
"extensions.showRecommendationsOnlyOnDemand": false并在扩展面板筛选@tag:preview - 预发布版不会触发自动更新（除非用户显式启用
extensions.autoUpdate并设为preview通道），但一旦安装，后续正式版发布仍会覆盖它 - 插件作者不能靠预发布“并行维护两个功能分支”，因为用户无法同时启用 preview + stable
离线环境必须修改 .vsix 才能绕过引擎校验
内网或锁版本机器上，直接双击安装 .vsix 文件会失败，报错 Extension is not compatible with Code x.x.x。这不是网络问题，而是 .vsix 内置的 extension/package.json 被严格校验：
- 用 7-Zip / Archive Utility /
unzip解压 .vsix（本质是 zip） - 编辑根目录下
extension/package.json中的engines.vscode字段 - 改完后重新打包为 zip，再将后缀名改回
.vsix - VSCode 不校验 .vsix 签名，但会检查内部
package.json结构；若字段格式错误（如多逗号、引号不闭合），安装会静默失败
最易被忽略的是 Remote-SSH 类插件：它前端部分受 engines.vscode 控制，远端部署的 vscode-server 却按本地主版本号拉取二进制，二者不一致就会卡在 Starting VS Code Server。降级插件时，远端 ~/.vscode-server 目录必须同步清理。
