最省事方式是url加?vscodeversion=x.x.x参数触发“install another version…”菜单;若灰显则需从github release下载.vsix,解压修改package.json中engines.vscode字段为宽松范围(如">=1.75.0"),重打包后通过“install from vsix”安装。

旧版插件不能靠 Marketplace 页面点“Install”直接获取——那个按钮永远只连最新版。必须用 URL 参数触发历史版本列表,或从 GitHub Release 下载可靠 .vsix 文件,再手动绕过兼容性校验。
怎么用 ?vscodeVersion= 强制显示旧版安装选项
这是最省事的路径,但前提是插件作者没下架历史版本,且你用的 VSCode ≥ 1.63。
- 打开插件市场页,例如
https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode - 在 URL 末尾追加
?vscodeVersion=1.79.2(把1.79.2换成你本地code --version输出的精确版本) - 刷新页面,右下角会出现
Install Another Version…下拉菜单 - 只选带绿色勾号 ✅ 的版本;若整个菜单灰显,说明该插件已撤下所有兼容版本,需走离线路径
GitHub Release 页面下载 .vsix 最稳
多数主流插件(如 ms-python.python、esbenp.prettier-vscode)都会在 GitHub 发布带 .vsix 的 assets,比 Marketplace 直链更可靠。
- 访问插件官方仓库的 Releases 页,例如
github.com/microsoft/vscode-python/releases - 找带
v前缀的 tag(如v2023.8.10280425),点开后在Assets区域下载.vsix文件 - 少数插件不发二进制包,但源码里有
package.json和npm run package脚本:需git clone→npm install→npm run package本地生成 - 极个别插件(如企业内部工具)没公开 release,只能查社区存档或联系作者索要
.vsix
手动拼接 marketplace _apis 直链下载旧版
当插件页面不响应 ?vscodeVersion=,或你想批量下载多个版本时,可用这个方法构造直链。
- 标准格式为:
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension-name}/{version}/vspackage - 其中
{publisher}是 ID 中.前部分(如MS-CEINTL.vscode-language-pack-zh-hans→MS-CEINTL) -
{extension-name}是.后部分,{version}必须完全匹配(如1.67.1不等于1.67.10),否则返回 404 - 可加
?targetPlatform=linux-x64指定平台,避免跨平台安装失败
装完提示 “not compatible with Code x.x.x” 怎么办
这不是网络错误,是 VSCode 严格校验 package.json 中的 "engines": {"vscode": "..."} 字段。原样安装会静默失败。
- 用 7-Zip(Windows)、Archive Utility(macOS)或
unzip(Linux)解压.vsix文件 - 编辑根目录下
extension/package.json,将"vscode": "^1.102.0"改为宽松范围,例如"vscode": ">=1.75.0"或精确锁定"vscode": "=1.79.2" - 保存后重新打包为
.zip,再把后缀名改回.vsix - 在 VSCode 中执行
Extensions: Install from VSIX命令安装 - 别跳过重打包步骤——VSCode 会校验
.vsix内部结构完整性,直接改原文件无效
最容易被忽略的是 Remote-SSH 类插件:它不仅有前端部分,还会在远端部署 vscode-server,这个二进制版本必须和本地 VSCode 主版本严格一致。降级后务必先删掉远端的 ~/.vscode-server 目录再重连。











