Archive 与 codeload 机制
在 GitHub 页面点击「Download ZIP」得到的源码包，来自 codeload.github.com：服务端会把指定版本的仓库内容动态打包成 zip 或 tar.gz。对应地址有三种粒度：
分支快照：https://github.com/owner/repo/archive/refs/heads/main.zip 标签快照：https://github.com/owner/repo/archive/refs/tags/v1.0.0.tar.gz 提交快照：https://github.com/owner/repo/archive/<提交哈希>.zip
拼接加速地址后即可获得对应的加速链接，例如：https://ghclone.com/https://github.com/owner/repo/archive/refs/tags/v1.0.0.tar.gz。
三种快照怎么选
- 分支快照：始终指向分支最新内容，适合尝鲜；但同一地址在不同时间会得到不同内容，不适合可复现构建
- 标签快照：指向发布版本，内容通常不变，适合大多数构建与部署场景
- 提交快照：锁定到具体提交，内容理论上不可变（哈希寻址），适合对可复现性要求最高的场景
在 CI 里固定版本并校验
构建脚本里下载源码包时，建议同时做到「固定标签」与「校验哈希」：
curl -fL -o src.tar.gz "https://ghclone.com/https://github.com/owner/repo/archive/refs/tags/v1.0.0.tar.gz" echo "预期的sha256 src.tar.gz" | sha256sum -c - tar -xzf src.tar.gz
哈希从发布方渠道获取（Release 说明、签名文件或官方校验清单）。校验失败立即终止构建，避免把不一致的源码打进产物。
离线构建与内网分发
内网构建环境无法直连外网时，可以在一台可联网的机器上提前把归档文件下载好，随构建镜像或制品库一起分发。这样构建过程不再依赖跨境链路，速度与稳定性都由内网保证；需要升级版本时，再走一次「下载—校验—更新制品」的流程。
常见问题
- 归档里没有 .git 目录？这是预期行为：源码快照不包含版本库元数据，
git describe之类的命令不可用。需要版本信息请在构建时通过参数注入。 - 子模块内容缺失？归档不包含子模块内容，需单独下载各子模块快照。
- 存档体积比仓库大？部分仓库含有大文件与历史资源，分支快照打包的是工作树内容，体积评估以实际下载为准。