微软自 2025 年起关闭了 VS Code 官方市场的 .vsix 文件直接下载入口，这给在企业内网或离线环境下工作的开发者带来了极大不便。本文将详细介绍目前已知的 3 种离线下载 VS Code 扩展的方法，帮助你找到最适合自己的方案。
方法一：VS Code 内置下载（有网环境）
如果你的设备可以访问外网且已安装 VS Code，这是最简单直接的方式。
操作步骤
- 打开 VS Code，点击左侧活动栏的"扩展"图标
- 在搜索框中输入扩展名称（如 "Python"）
- 找到目标扩展，右键单击
- 选择"下载 VSIX"选项
- 选择保存位置，.vsix 文件将下载到本地
✅ 优点：简单直接，无需第三方工具，官方原生支持
❌ 缺点：需要安装 VS Code、一次只能下载一个扩展、无法选择历史版本
适用场景：临时下载少量扩展
方法二：手动拼接下载 URL
VS Code 扩展的下载链接遵循固定格式，通过获取扩展的发布者、名称和版本号，可以手动拼接出下载地址。
URL 格式
如何获取参数
- 访问 VS Code Marketplace
- 搜索并进入目标扩展详情页
- 在右侧"Installation"栏中找到 identifier（格式：发布者.插件名）
- 在"Version"栏中找到版本号
平台参数（可选）
部分扩展与操作系统平台相关，可以在 URL 后添加 ?targetPlatform={平台} 指定：
win32-x64- Windows 64位darwin-arm64- macOS Apple Siliconlinux-x64- Linux 64位
✅ 优点：无需任何工具、可直接下载历史版本
❌ 缺点：容易出错、操作繁琐、无法批量下载、需要手动查找版本号
适用场景：只需要下载特定版本的单个扩展
方法三：Extensions Toolkit（推荐）
Extensions Toolkit 是专为解决企业内网、离线环境扩展下载问题而开发的免费工具，支持搜索、批量下载、历史版本选择等功能。
核心功能
插件搜索
直接输入扩展名称搜索，无需记住复杂的 identifier，支持模糊匹配。
URL 解析
粘贴 Marketplace 插件详情页 URL，自动解析并生成下载链接。
历史版本
支持选择任意历史版本下载，解决兼容性问题。
多平台支持
自动识别当前系统，支持 Windows、macOS、Linux 多平台下载。
批量下载
购物车功能，可同时添加多个扩展到下载列表，一键打包。
ZIP 打包
将多个扩展打包成 ZIP 文件，方便传输和批量安装。
使用方法
方式 A：插件搜索
- 访问 Extensions Toolkit - VS Code
- 在搜索框输入扩展名称（如 "Python"）
- 点击搜索结果中的扩展卡片
- 选择版本和平台，点击下载
方式 B：URL 解析
- 在 Marketplace 找到目标扩展，复制详情页 URL
- 访问 URL Tool
- 粘贴 URL，点击"生成下载链接"
- 选择版本和平台，下载 .vsix 文件
工作原理
Extensions Toolkit 通过以下步骤实现扩展下载：
- 根据用户输入的扩展名或 URL，调用 VS Code Marketplace 官方 API 获取扩展信息
- 解析扩展信息，获取所有可用版本和支持的平台
- 按照方法二介绍的 URL 规则，拼接出直接的下载链接
- 通过流式转发，将 .vsix 文件提供给用户下载
✅ 优点：功能最全、操作最简单、支持批量下载和历史版本、完全免费
适用场景：企业内网环境、批量部署、需要特定版本、追求效率的开发者
安全性：仅调用官方 API 拼接下载链接，不存储、不修改扩展文件
三种方法对比
| 对比项 | VS Code 内置 | 手动 URL | Extensions Toolkit |
|---|---|---|---|
| 操作难度 | ⭐ | ⭐⭐⭐ | ⭐ |
| 批量下载 | ❌ | ❌ | ✅ |
| 历史版本 | ❌ | ✅ | ✅ |
| 平台选择 | ❌ | ✅ | ✅ |
| 无需安装 VS Code | ❌ | ✅ | ✅ |
| 推荐指数 | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
离线安装指南
下载 .vsix 文件后，在离线环境中安装扩展：
拖拽安装（推荐）
打开 VS Code，点击左侧"扩展"图标进入扩展视图
在文件管理器中找到下载的 .vsix 文件
直接将 .vsix 文件拖拽到 VS Code 的扩展面板区域，松开鼠标即可自动安装
命令行安装（批量）
打开终端（Terminal）
执行安装命令（支持单个或批量）
💡 提示：拖拽安装是最直观简单的方式，无需记忆命令；命令行安装适合批量部署场景。
常见问题
Q: 如何判断扩展支持哪些平台？
在 Extensions Toolkit 的搜索结果中，如果扩展卡片左上方显示平台数量（如"支持 5 个平台"），说明该扩展区分平台；如果没有显示，说明是通用扩展，可在所有平台使用。
Q: 离线环境如何更新扩展？
需要在外网环境重新下载新版本的 .vsix 文件，然后在离线环境通过"从 VSIX 安装"覆盖安装。Extensions Toolkit 支持查看版本发布时间，帮助你选择最新版本。
Q: Extensions Toolkit 是否安全？
Extensions Toolkit 仅作为下载链接生成工具，不存储、不修改扩展文件。所有 .vsix 文件均直接从微软官方服务器下载，与通过 VS Code 内置功能下载的文件完全一致。
Q: 下载的扩展无法安装怎么办？
请检查：1) 扩展是否支持当前平台；2) VS Code 版本是否满足扩展要求；3) 是否下载了正确的架构版本（如 ARM64 vs x64）。可在 Extensions Toolkit 中查看扩展的详细兼容性信息。
结语
微软关闭官方 VSIX 下载入口确实给离线环境开发带来了不便，但通过上述方法，你仍然可以高效地获取和管理 VS Code 扩展。
对于偶尔下载单个扩展，方法一和方法二足够使用；但对于企业内网批量部署、需要特定版本或追求效率的场景，Extensions Toolkit 是最佳选择。
希望本文能帮助你解决离线环境扩展下载的问题。如果你有其他方法或建议，欢迎在评论区分享！