国内用户需手动配置 settings.json 中的 extensions.gallery.serviceurl 和 cacheurl 为微软中国 cdn（如 vscode.cdn.azure.cn）以解决 vscode 插件安装卡顿问题，因官方 azure cdn 在国内解析不稳定、tls 握手易超时且部分节点被限速。
VSCode 插件市场默认走微软全球 CDN，国内直连经常卡在“正在安装”或报 ENOTFOUND / ETIMEDOUT，换国内镜像源是最快见效的解法——但不是所有镜像都有效，且 VSCode 1.83+ 后配置方式有变化。
为什么官方源在国内慢？
VSCode 插件市场（https://marketplace.visualstudio.com）的插件包实际托管在 Azure CDN（如 vscode.blob.core.windows.net），该域名在国内解析不稳定、TLS 握手易超时，且部分节点被限速。用户点击“安装”后，VSCode 先查 manifest，再从 blob 下载 .vsix，任一环节失败都会卡住。
镜像源本质是反向代理 + 缓存，把 marketplace.visualstudio.com 和 vscode.blob.core.windows.net 的响应缓存在国内服务器上，跳过跨境链路。
有效镜像源及对应配置方式（VSCode 1.83+）
目前稳定可用的镜像只有两个，且必须通过 settings.json 手动设置，UI 设置页已移除相关入口：
-
"extensions.autoUpdate": false—— 建议先关自动更新，避免镜像未生效时后台静默失败 -
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/api/gallery"—— 指向微软中国 CDN（官方支持，延迟低，但不缓存全部插件） -
"extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/api/gallery/cache"—— 必须配，否则 serviceUrl 不生效 - 备选（第三方）：
"extensions.gallery.serviceUrl": "https://marketplace.visualstudio.com.cn/api/gallery"—— 非官方，部分新插件同步滞后，但覆盖更全
⚠️ 注意：serviceUrl 结尾不能带 /，否则 VSCode 会拼出错误路径导致 404；cacheUrl 必须与 serviceUrl 同域，否则被忽略。
验证是否生效 & 常见失败原因
改完配置重启 VSCode，在命令面板运行 Developer: Toggle Developer Tools，切换到 Console 标签，然后尝试搜索一个插件（如 Python）。成功时你会看到请求发往你配置的域名，例如：
GET https://vscode.cdn.azure.cn/api/gallery/publishers/ms-python/vsextensions/python/2024.6.0/vspackage
如果仍看到 marketplace.visualstudio.com 或报 ERR_CONNECTION_REFUSED，检查以下几点：
- 配置写在了用户 settings（
settings.json），而非工作区 settings（后者不生效） - 用了代理软件（如 Clash、Surge），其规则可能劫持了
vscode.cdn.azure.cn导致 502 - 系统 hosts 文件里手动绑定了
marketplace.visualstudio.com，会覆盖镜像配置 - 插件本身含远程资源（如主题预览图），这些仍走原地址，不影响安装，但界面可能显示空白
镜像不是万能的——它只加速插件元数据和 .vsix 包下载，插件运行时依赖的外部服务（比如 GitHub API、Pylint 远程检查）完全不受影响。真要彻底提速，得配合靠谱的全局代理，但那是另一回事了。
