VSCode本体下载需替换CDN域名为vscode.cdn.azure.cn;终端工具需按优先级配置国内源(npm/pip/go/mvn);插件市场须在用户settings.json中配对serviceUrl与cacheUrl;自动更新需手动修改product.json中的extensionsGallery字段。

VSCode 本身没有“命令行安装”这个原生操作——它不是通过 npm install 或 pip install 安装的桌面应用。你实际想做的,是用命令行(或下载链接)**绕过海外 CDN,直连国内镜像下载 VSCode 安装包**,或者在 VSCode 集成终端里让 npm/pip/go/mvn 等工具走国内源。这两类场景必须分开处理,混在一起配只会失效。
VSCode 本体下载慢?直接替换下载链接里的域名
VSCode 官网下载慢,99% 是因为原始链接指向 az764295.vo.msecnd.net 这类海外 CDN 域名。不用代理、不改系统设置,最稳的办法就是手动换域名:
- 打开 https://www.php.cn/link/30580a4caf21ef930b7774a2eff4aa26,选中你要的版本(如 Windows x64)
- 点击下载,等浏览器显示“准备下载”时,右键下载条目 →「复制链接地址」
- 把链接里
https://az764295.vo.msecnd.net/替换成https://vscode.cdn.azure.cn/,其余路径(如/stable/xxx/VSCodeSetup-x64.exe)保持不变 - 粘贴进新标签页回车,基本秒开 —— 这是微软官方运营的镜像,SHA256 和源站一致,安全可靠
注意:别信“用 curl + proxy 下载”的方案,既多一步又容易证书失败;也别改 hosts 绑定旧域名,az764295.vo.msecnd.net 已逐步弃用。
VSCode 终端里 npm/pip/go/mvn 还走国外源?检查配置优先级
你在 VSCode 终端里执行 npm install 或 pip install 慢,问题不在 VSCode,而在这些工具自身的配置文件读取顺序。VSCode 的集成终端只是个 shell,它完全遵循对应工具的配置规则:
-
npm:项目根目录下的.npmrc> 用户级C:\Users\{user}\.npmrc(Windows)或~/.npmrc(macOS/Linux)> 全局配置。旧淘宝源https://registry.npm.taobao.org/已停用,必须换成https://registry.npmmirror.com/ -
pip:优先读pip.conf(Linux/macOS)或pip.ini(Windows),其次才是命令行--index-url。推荐执行:pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/ -
go:依赖环境变量,不是配置文件。export GOPROXY=https://goproxy.cn,direct必须写入~/.zshrc或~/.bash_profile并执行source,否则 VSCode 终端启动时不会加载 -
mvn:只认settings.xml,默认路径是$M2_HOME/conf/settings.xml。插件市场里搜 “Maven for Java” 装了也没用,它不改 Maven 自身行为
验证是否生效:在 VSCode 终端里运行对应命令,比如 npm config get registry,输出必须是新地址;如果还是旧地址,说明有更高优先级的 .npmrc 文件在项目里没删干净。
插件市场/语言包卡在“正在安装”?settings.json 必须配对 serviceUrl + cacheUrl
中文语言包、任何插件安装慢或报 ETIMEDOUT/ENOTFOUND,本质是 VSCode 插件市场请求发到了 marketplace.visualstudio.com。光改 extensions.gallery.serviceUrl 不够,1.83+ 版本起必须同时配 cacheUrl,否则整个配置被忽略:
- 按
Ctrl+Shift+P→ 输入Preferences: Open Settings (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进程
别在工作区 settings 里写,只写用户 settings(全局)才生效;也别信网上教你在 settings.json 里配 http.proxy,那对插件市场无效。
自动更新也想走国内镜像?必须手动改 product.json
VSCode 的自动更新逻辑不读 settings.json,它硬编码在安装目录内的 product.json 文件里。想让每次检查更新、下载新版都走国内 CDN,只能手动编辑:
- 找到 VSCode 安装目录:
Windows 通常是C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\resources\app\product.json
macOS 是/Applications/Visual Studio Code.app/Contents/Resources/app/product.json - 用文本编辑器打开,搜索
extensionsGallery字段,把里面的serviceUrl和cacheUrl值全替换成:"https://vscode.cdn.azure.cn/api/gallery"和"https://vscode.cdn.azure.cn/api/gallery/cache" - 保存,重启 VSCode —— 此后所有自动更新请求都会命中国内镜像
这是唯一能让自动更新也提速的方法。改完别忘了备份原 product.json,下次 VSCode 升级可能会覆盖它。











