vcpkg现状

vcpkg 国内使用现状（2025-09）

1. 官方是否支持改源？

否。
vcpkg 没有镜像源配置项，所有下载地址写死在 portfile 或工具链里，官方不提供、不计划提供换源接口。

2. 资产缓存能做什么？

• 只缓存已下载过的压缩包、工具包
• 不能提前“偷渡”文件，也不能把 GitHub 地址变成国内地址
• 用法：

  # 第一次正常下载，同时写入缓存
  X_VCPKG_ASSET_SOURCES=x-azurl,file:///mnt/cache,readwrite \
  ./vcpkg install zlib
  # 后续同一版本直接读缓存，无需联网

3. 国内唯一可靠方案

给终端整机配 HTTP(S) 代理，让 vcpkg 走代理访问 GitHub/Azure CDN；
CI 环境可预跑一遍，把缓存目录 /mnt/cache 整体打包进内网，后续离线使用。

4. 不存在的功能

• 官方镜像源
• 阿里云/清华“一键换源”
• 修改 X_VCPKG_ASSET_SOURCES 实现“加速”

以上均未在官方文档出现.

---

https://learn.microsoft.com/zh-cn/vcpkg/consume/asset-caching?pivots=shell-powershell

结论：vcpkg 在国内无解源，只能代理或离线缓存。