能用的官方直链是https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，需严格匹配publisher（如ms-python）、extension_name（如python）、version（如2026.8.123456）三要素。
怎么拼出能用的官方直链
官网插件页不显示旧版本下载按钮，是因为微软后端动态控制 UI，不是你网络或浏览器的问题。真正可靠的方式是手拼 Marketplace 的 API 下载地址：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage。这个 URL 不依赖登录态、不跳转、不缓存，填对三要素就能下到带签名的正确版本。
三个字段必须严格匹配：
-
publisher：插件页右上角 “Publisher” 后面的 ID，比如ms-python（注意不是 GitHub 用户名，也不是全大写） -
extension_name：看 “Unique Identifier”，取小数点后半段，比如ms-python.python→ 填python；MS-CEINTL.vscode-language-pack-zh-hans→ 填vscode-language-pack-zh-hans（大小写敏感） -
version：必须和 Version History 页面里“Version”列显示的完整字符串一字不差，比如2026.8.123456，少一位、多空格、用latest都会 404
怎么找对目标版本号
新版 Marketplace 页面已移除历史版本的下载入口，但 Version History 列表仍保留所有发布记录。关键动作不是“猜”，而是“抄”：
- 打开插件页，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python - 点击右侧 “Version History” 标签页
- 找到你要的版本行，鼠标选中右侧“Version”列的完整值（含全部数字和点），直接复制
- 粘贴进上面的 URL 模板，替换
{version}部分
常见错误：把 Requirements 栏写的最低 VS Code 版本（如 “VS Code >= 1.85”）当成插件版本号；或从 GitHub Release 页面抄版本，结果 engines.vscode 字段不匹配，安装时报兼容性错误。
命令行安装时为什么报 INVALID_SIGNATURE
离线环境执行 code --install-extension python.vsix 报这个错，不是文件损坏，而是 VS Code 尝试校验证书吊销列表（CRL）失败——它需要联网访问微软 OCSP 服务器，但内网机器根本连不上。
唯一有效解法是加 --allow-unverified 参数：
code --install-extension python.vsix --allow-unverified
注意：--allow-unverified 是强制绕过签名校验，不是“忽略警告”。没有它，离线安装必然失败；有它，只要 .vsix 本身是从官方渠道下载的，功能完全正常。
路径和环境细节容易被跳过
即便 URL 拼对、参数加了、文件也下载了，安装仍可能静默失败。几个硬性条件必须满足：
-
code命令必须可用：不是 PATH 问题，而是 VS Code 从未启用 Shell Command。在有网的 VS Code 里按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 路径不能含中文或空格：Windows 上
C:\用户\插件\python.vsix会失败；推荐用纯英文路径，如C:/vsix/python.vsix，并用双引号包裹 - VS Code 进程必须彻底退出：装完不生效？检查系统托盘、任务管理器（Windows）或 Activity Monitor（macOS），杀掉所有
Code.exe或Code Helper进程再重试
最常被忽略的是“版本与 VS Code 主体兼容性”——比如你下了 python-2026.8.123456.vsix，但服务器上的 VS Code 是 1.84，而该插件要求 >= 1.85，就会装上但不激活。务必对照插件页 Requirements 栏核对。
