唯一稳下载方式是手拼官方URL:https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage,三字段须严格匹配大小写、连字符与点号,缺一不可。

marketplace.visualstudio.com 是唯一官方插件来源,但“Download”按钮已被微软动态隐藏——它只对**未安装过该插件的用户**显示,且仅限当前平台最新版。想稳定下载(尤其是离线、历史版本、指定平台),必须手拼 URL。
为什么官网页面找不到 Download 按钮?
微软从 2025 年起逐步移除公开下载入口,后端根据用户登录状态、已安装扩展列表、操作系统等条件控制按钮显隐。常见现象包括:
- 页面右侧
Installation栏只有Install按钮,无Download - 点击
Install直接跳转 VS Code 内安装,不提供 .vsix 文件 - 同一插件,在同事电脑上能看到下载按钮,你却看不到
如何拼出有效的离线下载链接?
核心 URL 模板是:
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage
三个变量必须严格匹配,大小写、连字符、点号都不能错:
-
publisher:取自插件主页 URL 或identifier字段中.前的部分,例如ms-python(不是Microsoft) -
extension_name:identifier中.后的部分,例如python(不是Python或vscode-python) -
version:插件详情页右上角Version字段的原始值,如2025.1.2025022102,不能四舍五入或省略前导零
示例(Linux 平台 Python 插件):
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2025.1.2025022102/vspackage?targetPlatform=linux-x64
怎么快速拿到 publisher / extension_name / version?
别手动猜,直接看插件主页源信息:
- 打开插件页面(如 https://www.php.cn/link/3d29fb5278af9da98e9e7c9d3c97b9e2)
- 按
Ctrl+U(或Cmd+Option+U)查看网页源码 - 搜索
"identifier"或"version",定位 JSON 片段,里面字段值就是准确值 - 更省事:用浏览器插件
Extensions Toolkit,装好后在插件市场页右上角多出URL Tool菜单,点开可一键复制带平台参数的下载链接
targetPlatform 参数到底要不要加?
加不加取决于插件是否含原生二进制依赖:
- 纯 JS/TS 插件(如
ESLint、Prettier):可不加,通用 - 含编译模块的插件(如
Python、C/C++、Rust):必须加,否则安装时报Unsupported platform - 平台标识必须精确,
linux-x64和linux-arm64互不兼容,darwin-arm64不能混用 Intel Mac
常见值:win32-x64、darwin-arm64、linux-x64、linux-arm64
publisher 和 extension_name 的大小写与分隔符——比如 bradlc.vscode-tailwindcss 的 publisher 是 bradlc,不是 BradLC;extension_name 是 vscode-tailwindcss,不是 tailwindcss。错一个字符,404 就来了。


















