右键下载VSIX仅在插件未安装或已禁用时有效；已启用则选项消失，卸载后右键可能下载旧版，应先禁用再下载；拼URL需准确填写publisher、extension_name和version三要素，否则404；推荐用vsixget工具自动获取真实版本与链接。
右键下载 VSIX 只在未安装时有效
VS Code 桌面版自带下载功能，但菜单项是否出现取决于插件状态：只有插件**未安装**或**已禁用**时，右键才会显示 Download Extension VSIX；如果插件已启用，右键菜单里这个选项直接消失。很多人卸载后再右键，结果下到的是旧版——因为卸载不等于版本回退，VS Code 缓存的仍是上次安装的元数据。
正确做法是：先禁用插件 → 右键 → 下载。下载路径默认为系统“下载”目录，文件名类似 ms-python.python-2026.10.1.vsix，建议立刻重命名，显式带上平台和日期，例如 python-20261027-win32-x64.vsix，避免后续在 M 系列 Mac 或 Linux 服务器上误用。
- 某些插件（如
rust-lang.rust-analyzer）右键无反应？说明它没上架 Marketplace，得走 GitHub Releases 或其他渠道 - 禁用后仍看不到下载项？检查插件 ID 是否含特殊字符（如大写字母、下划线），部分插件 manifest 声明不规范会导致 UI 渲染异常
拼 URL 下载必须填对 publisher、extension_name、version 三要素
官方 API 接口稳定，但容错极低：字段错一位、大小写不对、版本号抄错（比如把 Version History 里的 2026.10.1 写成 2026.10），就返回空页或跳转首页，浏览器不报错，只卡住——你以为成功了，其实 404 了。
URL 格式固定为：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage。其中：
-
publisher是itemName中小数点前半段（ms-python.python→ms-python） -
extension_name是小数点后半段（ms-python.python→python），注意不是仓库名或显示名 -
version必须从插件页面的 Version History 栏顶部找标Latest的那行，复制完整数字（2026.10.1），别信右上角写的 “v1.2.3”，那是 manifest 版本，常与 marketplace 发布版不一致
vsixget 工具比手拼 URL 更稳
vsixget 不依赖人工识别字段，它直接调用 Marketplace 后端接口，自动解析最新兼容版本、生成带签名的直链，并内置重试和缓存逻辑。尤其适合批量操作或 CI 脚本。
安装和使用极简：
pipx install vsixget vsixget --latest ms-python.python
执行后会输出真实下载地址和保存路径，文件名自动包含平台标识（如 darwin-arm64）。它还会校验 engines.vscode 字段，跳过不兼容你当前 VS Code 版本的扩展，避免装上就静默禁用。
- Windows 上 PowerShell 执行需加引号：
vsixget "jiyegui.fast-pytest-runner"，否则空格或短横线会被 shell 截断 - 企业内网若限制 User-Agent，可加
--user-agent参数模拟 VS Code 客户端请求头
code --install-extension 离线安装必须加 --allow-unverified
离线环境无法连接微软证书服务，code --install-extension python.vsix 会直接报 INVALID_SIGNATURE 并退出，错误信息就这一行，毫无上下文。不加 --allow-unverified 参数，命令必败。
其他关键前提：
- 所有 VS Code 实例必须关闭（包括托盘进程），Windows 可用任务管理器结束全部
Code.exe，否则插件加载冲突，code --list-extensions不显示，重启后也不生效 - 路径含中文或空格（如
C:\用户\张三\vsix\python.vsix）会静默失败，务必移到纯英文路径，例如C:\vsix\python.vsix - 装完不工作？打开命令面板运行
Developer: Show Running Extensions，看是否真在运行；很多插件（如 Python）强依赖ms-python.pylance，缺一个就功能残缺
真正难的不是“怎么下”，而是确认那个 .vsix 文件本身是否匹配你的 VS Code 版本、操作系统架构、以及是否带全依赖——这三个条件漏一个，装上也白搭。
