右键下载最简单但仅限未安装插件时可见；已安装需先禁用再右键，否则可能下载旧版；插件未上架marketplace则需拼url或从github下载；拼url必须准确填写publisher、extension_name（小数点后半段）和version三要素，否则404；推荐使用vsixget工具自动获取真实版本和下载链接。
右键下载最简单，但只在未安装时可见
VS Code 桌面版自带下载功能，前提是插件还没装上。打开扩展面板（Ctrl+Shift+X），搜到目标插件（比如 ms-python.python），鼠标悬停后右键——菜单里出现 Download Extension VSIX 才能点；如果已安装，这个选项就消失了。
常见错误：点了“卸载”再右键，发现选项还在，但下载的是旧版本（不是当前启用的版本）。正确做法是先禁用插件，再右键下载，确保拿到最新版。
- 下载路径默认在系统“下载”目录，文件名形如
ms-python.python-2026.8.1.vsix - 建议立刻重命名，加上日期或用途，比如
python-20260811.vsix，避免后续混淆 - 某些插件（如
rust-lang.rust-analyzer）右键无反应？那是它没上架 Marketplace，得走 GitHub Releases 或其他渠道
拼 URL 下载要填对三要素，版本号不能错
Marketplace 网页不显示下载按钮，但后台 API 是公开的。构造链接必须严格匹配三个字段：publisherName、extensionName、version。漏一个或拼错大小写，404 直接返回空页，浏览器不会报错，只会卡住或跳转首页。
例如 Python 插件最新版是 2026.8.1，链接就得写成：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2026.8.1/vspackage
获取版本号的可靠方式只有两个：
- 进插件页面 → 点
Version History→ 找顶部标Latest的那行，复制数字（别信页面右上角写的“v1.2.3”，那个常是 manifest 版本，不是 marketplace 版本） - 用
vsixget工具自动查：vsixget jiyegui.fast-pytest-runner，它会请求 API 并输出真实版本和下载地址
命令行工具 vsixget 比手拼 URL 更稳
vsixget 不依赖人工找版本号，也不怕 URL 格式微调。它模拟 VS Code 客户端行为，直接调用 Marketplace 的公开接口，拿到的是服务端返回的真实下载链接，且带重试和缓存逻辑。
安装和使用很简单：
pipx install vsixget<br>vsixget --latest ms-python.python
执行后生成 ms-python.python-2026.8.1.vsix 文件，放在当前目录。注意：
- 不用加
https://前缀，输ms-python.python就行，ID 格式必须和 Marketplace URL 里的完全一致（区分大小写） - 如果提示
No versions found，大概率是 ID 输错了，去插件页 URL 里抄：https://marketplace.visualstudio.com/items?itemName=ms-python.python，itemName=后面那段就是 ID - 离线环境部署时，建议用
--version 2026.8.1锁定版本，避免下次运行时拉到不兼容的新版
code --install-extension 报错，八成是路径或权限问题
拿到 .vsix 文件后，命令行安装最常用，但失败原因高度集中：
-
command not found: code→ 还没把 VS Code CLI 加入 PATH。在 VS Code 里按Ctrl+Shift+P，运行Shell Command: Install 'code' command in PATH，重启终端 -
ENOENT或静默失败 → 路径含空格或中文，必须用引号包裹：code --install-extension "/home/user/my ext/python.vsix" - 装完不生效 → 不是没装上，而是插件依赖的语言服务器（如
pyright）没离线部署。VS Code 只注册插件，首次启用才触发外网下载，离线环境下会卡在状态栏“Downloading…”
真正麻烦的从来不是下载本身，而是确认 .vsix 文件是否完整、VS Code 版本是否匹配、以及那些藏在背后的 runtime 依赖有没有同步到位。
