最稳方式是用官方API拼URL下载.vsix：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，需准确提取publisher、extension_name（小数点后半段）和version，避免404或文件损坏。
直接用官方 API 拼 URL 下载 .vsix 最稳
VS Code 插件的离线安装包（.vsix）其实一直能下，只是官网藏了下载按钮。核心原理是：所有插件都走同一个后端接口，拼对 URL 就能直链下载。
真实可用的格式是：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage
-
publisher：插件详情页右上角 “Publisher” 后面的 ID，比如ms-python、eamodio -
extension_name：看 “Unique Identifier”，点开是ms-python.python，取小数点后半段python -
version：页面右侧 “Version” 显示的数字，如2026.2.123456；若需旧版，点 “Version History” 选对应条目
常见错误：把 Unique Identifier 整个当 extension_name（比如填 ms-python.python），结果 404；或版本号抄错一位，下下来的文件打不开。
插件页面右键下载？只对未安装插件有效
在 VS Code Marketplace 页面，如果插件状态是 “Install”，鼠标右键它，菜单里会出现 “Save link as…” —— 这是微软留的快捷入口，但仅限未安装状态。
一旦你装过又卸载了，或者别人装过，这个右键选项就消失。不是浏览器问题，是服务端根据登录态+安装记录动态隐藏的。
- 适用场景：快速拿最新版，且你机器上从没装过该插件
- 不适用场景：内网批量部署、需要指定历史版本、插件已进过本地缓存
- 替代方案：开无痕窗口 + 登出账号，再访问插件页，可恢复右键下载
别信第三方“聚合站”，优先验证 vsix 签名和哈希
像 https://vsix.2i.gs/ 或某些中文镜像站，确实能搜到插件并提供下载链接，但它们本质是代理或缓存——不保证实时性，更不保证签名完整。
VS Code 启用插件前会校验 .vsix 内置签名。如果从非官方源下载，遇到以下情况基本就是签名失效：
- 安装时报错：
Extension is not signed by Microsoft - 插件列表里显示 “Disabled” 且无法启用
- 启动时弹窗警告 “This extension may have been tampered with”
实操建议：下载后用 sha256sum xxx.vsix 对比官网插件页 “Version History” 里公布的哈希值（如有）；没有的话，宁可多花两分钟手拼官方 URL。
离线安装后插件不生效？检查 VS Code 版本兼容性
不是所有 .vsix 都能在任意 VS Code 版本上运行。插件 package.json 里声明的 engines.vscode 字段，决定了最低支持版本。
比如你用的是 VS Code 1.85，但下载的 gitlens 是为 1.90 编译的，安装成功但启动时报错：Cannot activate extension 'gitlens' because it depends on a newer version of VS Code。
- 查兼容性：打开插件官网页 → 点 “Version History” → 找对应版本 → 展开 “Details” 看
VS Code version - 内网环境建议：统一记录团队所用 VS Code 的
code --version输出，下载插件前先核对 - 旧版插件难找？去 GitHub 仓库的
releases页翻 tag，很多作者会把旧.vsix附在 assets 里
最常被忽略的一点：VS Code Insiders 版本和 Stable 版本的插件不完全互通，哪怕版本号接近，也别混用。
