vscode下载、插件市场及自动更新均需配置vscode.cdn.azure.cn镜像源：替换下载链接域名提速本体安装；在settings.json中配置extensions.gallery.serviceurl和cacheurl加速插件加载；修改product.json中extensionsgallery字段实现自动更新走国内cdn。
vscode.cdn.azure.cn 是当前最稳定、微软官方支持的国内镜像源，直接替换下载域名或配置 settings.json 即可解决中文环境安装慢的问题——不是“试试看”，而是必须改，否则 VSCode 本体、插件市场、自动更新三处都会卡在连接阶段。
怎么手动换下载链接提速本体安装
VSCode 官网下载慢，99% 是因为原始链接指向海外 CDN 域名（如 az764295.vo.msecnd.net），数据绕行导致高延迟甚至超时。改域名是最轻量、最即时生效的办法。
- 打开 https://www.php.cn/link/30580a4caf21ef930b7774a2eff4aa26，选中你要的版本（如 Windows x64）
- 点击下载，等浏览器开始“准备下载”后，右键下载管理器条目 → 「复制链接地址」
- 把链接里
https://az764295.vo.msecnd.net这部分，替换成https://vscode.cdn.azure.cn，保留后面完整路径（如/stable/VSCodeSetup-x64-1.88.0.exe） - 粘贴进新标签页回车，基本秒开下载
注意：vscode.cdn.azure.cn 是微软 Azure 官方运营的中国区 CDN，SHA256 校验值与源站完全一致，安全性无需怀疑；别用已失效的 vscode.bj.bcebos.com 或未同步的第三方镜像。
为什么插件市场还是卡在“正在加载”
改了下载链接只解决本体安装，插件市场走的是另一套地址，默认直连 marketplace.visualstudio.com，国内极易 TLS 握手超时或被重置。
- 按
Ctrl+Shift+P→ 输入Preferences: Open Settings (JSON)回车 - 添加以下两行（注意加逗号，且必须和已有配置在同一 JSON 对象内）：
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/api/gallery", "extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/api/gallery/cache"
- 保存后，彻底退出 VSCode 进程（Windows 右键任务栏图标选「退出」，macOS 用 Activity Monitor 杀掉所有
Code进程），再重新打开
关键细节：serviceUrl 结尾不能带 /，否则拼出错误路径导致 404；cacheUrl 必须与 serviceUrl 同域，否则被忽略；配置必须写在用户级 settings.json，工作区配置不生效。
命令行安装插件失败（code --install-extension）怎么办
命令行安装失败，往往不是网络问题，而是环境变量未继承或镜像未覆盖全部请求路径，尤其在 CI/CD、远程开发或代理开启场景下高频出现。
- 确保先设置环境变量再运行命令：
VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn code --install-extension esbenp.prettier-vscode
- 如果仍报
connect ETIMEDOUT或卡在pending，说明 VSCode 进程继承了系统代理（比如 Clash 正在运行但未全局），需临时关闭代理，或显式禁用：code --proxy-settings=off --install-extension ms-python.python
- 某些插件（如
ms-python.python）会额外请求语言服务器二进制包，这部分不走 gallery 协议，镜像源对其无效——只能靠代理或离线下载
手动下载 .vsix 后安装失败，大概率是文件损坏或杀软拦截：用 unzip -t xxx.vsix（Linux/macOS）或 7-Zip「测试压缩包」（Windows）校验完整性；避免放在 OneDrive/iCloud 同步目录，临时禁用 Windows Defender 实时防护再试。
自动更新也想走镜像？必须改 product.json
VSCode 自动更新不读 settings.json，它只认内置的 product.json 文件。如果你希望每次检查更新、下载新版安装包都走国内 CDN，就必须手动编辑这个文件。
- 路径因系统而异：
– Windows：%USERPROFILE%\AppData\Local\Programs\Microsoft VS Code\resources\app\product.json
– macOS：/Applications/Visual Studio Code.app/Contents/Resources/app/product.json
– Linux：/usr/share/code/resources/app/product.json - 找到
"extensionsGallery"字段，把其中的"serviceUrl"和"cacheUrl"的值都改为https://vscode.cdn.azure.cn/api/gallery和https://vscode.cdn.azure.cn/api/gallery/cache - 修改后需重启 VSCode 才能生效；若权限不足，可能需要管理员/root 权限保存
这个步骤最容易被跳过，结果就是你配好了插件市场，但每次弹出更新提示后点「立即更新」，又回到龟速下载——因为更新通道根本没走镜像。
