直接替换域名即可加速下载VSCode本体:将官网链接中的az764295.vo.msecnd.net改为vscode.cdn.azure.cn;插件市场需配置serviceUrl和cacheUrl;命令行安装需设VSCODE_EXTENSIONS_MSA_URL;自动更新需修改product.json;语言服务器二进制包仍需代理或离线处理。

直接换域名就能下载 VSCode 本体,别等“准备下载”结束
VSCode 官网下载慢,不是你的网络问题,而是原始链接指向微软海外 CDN 域名 az764295.vo.msecnd.net。它不走代理、不看系统设置,只认域名——把这一段替成 vscode.cdn.azure.cn 就行。
操作要点:
- 点击官网下载按钮后,**不要点“保存文件”**,等浏览器显示“准备下载”时,右键下载管理器条目 →「复制链接地址」
- 粘贴出来类似
https://az764295.vo.msecnd.net/stable/1.88.0/VSCodeSetup-x64-1.88.0.exe的链接 - 只替换开头的
https://az764295.vo.msecnd.net为https://vscode.cdn.azure.cn,其余路径一个字都不能改 - 粘贴进新标签页回车,下载立刻开始;这个镜像由微软 Azure 官方运营,SHA256 校验值与源站完全一致
插件市场卡在“正在加载”?settings.json 必须配 serviceUrl 和 cacheUrl
装完 VSCode 后插件市场还是空白或转圈,是因为插件请求走的是另一套地址,默认直连 marketplace.visualstudio.com,国内访问大概率 TLS 握手超时或 DNS 解析失败。
必须同时配置两个字段,缺一不可:
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/api/gallery""extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/api/gallery/cache"- 两个 URL 必须同域、结尾不能带
/,否则拼接路径出错(比如变成/gallery//publishers导致 404) - 配置必须写在**用户级 settings.json**(不是工作区),路径:
%APPDATA%\Code\User\settings.json(Windows)、~/Library/Application Support/Code/User/settings.json(macOS)
code --install-extension 命令仍超时?环境变量 VSCODE_EXTENSIONS_MSA_URL 才管用
命令行安装插件不读 settings.json,它走的是独立环境变量路径。即使你配好了镜像,code --install-extension 还是会连境外服务器。
临时生效方法:
- 终端里先执行:
VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn code --install-extension esbenp.prettier-vscode - CI/CD 或远程开发中,需在构建脚本里显式导出该变量
- 如果仍报
ETIMEDOUT或卡在pending,检查是否后台开着 Clash/Surge 等代理工具——它们常默认启用系统代理但未全局,会干扰code命令的 DNS 解析
自动更新失败?product.json 是唯一生效位置
VSCode 弹窗提示“有新版本可用”时的下载行为,不读 settings.json,也不认环境变量,它硬编码在安装目录下的 product.json 文件里。
Windows 示例路径:C:\Users\<username>\AppData\Local\Programs\Microsoft VS Code\resources\app\product.json</username>
找到 extensionsGallery 字段,修改其中的 serviceUrl 和 cacheUrl 为国内镜像地址,例如:
"serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/""cacheUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/cache"- 改完必须彻底退出 VSCode 进程(Windows 右键任务栏图标选「退出」,macOS 用 Activity Monitor 杀掉所有
Code进程),再重启
最易被忽略的一点:插件的语言服务器二进制包(如 ms-python.python 自动拉取的 pylsp)完全绕过 gallery 协议,镜像源对其无效——这部分只能离线下载或配 HTTP 代理。


















