vscode插件下载卡住本质是无法访问marketplace.visualstudio.com，解决方案包括：手动构造api下载链接（如https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension}/{version}/vspackage）、切换vscode.cdn.azure.cn等国内镜像源并彻底重启、使用code --install-extension命令行安装并确保版本与id准确。
VSCode 插件下载卡在“正在安装”或根本搜不到、下不动，基本就是网络链路问题——不是插件本身有问题，而是你连不上微软的 marketplace.visualstudio.com 服务端。2025 年起官方已关闭直接下载链接入口，离线场景必须靠构造 URL 或换源解决。
怎么手动构造 .vsix 下载链接（适用于内网/断网环境）
官方市场页面不再显示“Download Extension”按钮，但 API 接口仍可用。关键是要拼出正确的 _apis/public/gallery/publishers/{publisher}/{extension}/{version}/vspackage 路径。
- 打开插件页，比如 C/C++ 插件：https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools
- 从 URL 或插件详情页确认三要素：
publisher（ms-vscode）、extension（cpptools）、version（如 1.30.5） - 拼接完整地址：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-vscode/vsextensions/cpptools/1.30.5/vspackage - 在能联网的机器上访问该链接，浏览器会直接触发 .vsix 文件下载
- 注意：版本号必须精确匹配，错一位就 404；插件 ID（如
ms-python.python）和发布者名不总一致，别凭印象瞎填
国内镜像源怎么用才真正生效
改 extensions.gallery.serviceUrl 设置只是第一步，很多用户设了却没效果，是因为 VSCode 启动时已缓存旧域名，或被系统 hosts / 代理干扰。
- 设置方式：打开 VSCode 设置（Ctrl+,），搜索
extensions.gallery.serviceUrl，改为https://vscode.cdn.azure.cn - 必须重启 VSCode 才生效，仅重载窗口不够
- 如果仍慢或失败，检查是否开了系统代理；有代理时 VSCode 可能绕过该设置直连原始域名
- 镜像站不保证 100% 同步，某些新发布插件可能延迟几小时才上线，此时只能回退到手动构造链接方式
命令行批量安装插件时容易漏掉的关键点
code --install-extension 看似简单，但在 CI/CD 或多用户部署中常因环境配置失败。
- 必须确保
code命令已加入 PATH，Windows 上默认勾选“Add to PATH”才可用；macOS/Linux 需手动执行Shell Command: Install 'code' command in PATH - 插件 ID 必须写全，比如 Pylance 是
ms-python.pylance，不是pylance或python - 安装过程无进度条，只输出成功/失败日志；加
--force可覆盖已存在版本，否则同版本会跳过 - 某些插件（如 Copilot）依赖登录状态，命令行安装后首次启用仍需手动登录，不能全自动完成
最麻烦的不是找不到下载方式，而是不同场景要切换策略：内网机器靠手动拼 URL，开发机靠镜像源，自动化部署靠 CLI —— 没有银弹。尤其要注意插件版本号和 ID 的准确性，错一个字符就白忙半小时。
