远程 Mac上跑 Rust CI 时，cargo 常因跨境抖动失败；镜像与官方混用又易引发锁文件争议。本文用决策矩阵说明直连、稀疏镜像与重试参数，并覆盖证书代理与子模块注意。内链：博客列表、依赖拉取 FAQ、首页与帮助中心（免登录）。🦀🚀
痛点拆解：跨境、锁文件与团队一致性
- 两跳链路：稀疏索引与 crate 下载任一超时都会卡在 fetch，需同时调高重试与 HTTP 超时。
- 锁文件即契约：换镜像不应改解析；若漂移，先查 Rust 版本与
config.toml是否人人一致。 - 缓存键：缓存
target与注册表时纳入镜像标识与工具链版本，避免远程机偶发差异。
选型决策矩阵：镜像源、重试与 lockfile 一致性
| 策略 | 适用场景 | lockfile 期望 | 主要风险 |
|---|---|---|---|
| 直连官方稀疏索引 | 近源或链路稳 | 与默认一致 | 跨境延迟断流 |
| 公共稀疏镜像 | 大陆或抖动明显 | 解析不变锁不变 | 同步滞后 |
| HTTP 代理出口 | 企业审计出境 | 通常不变 | 证书与代理超时 |
| vendor 提交 | 离线合规 | 锁文件加 vendor | 体积与升级成本 |
全员统一其一：sparse+https://mirrors.ustc.edu.cn/crates.io-index/ 或 sparse+https://rsproxy.cn/index/，下载域名按官方文档配对。镜像只改下载路径，不应动依赖图；若锁文件莫名变化，优先比对 rustc 与成员本地配置是否一致。
远程 Mac CI 三步配置（环境变量 + 配置 + 缓存）
落地步骤（含扩展两步）
- 一：导出
CARGO_NET_RETRY=10、CARGO_HTTP_TIMEOUT=600（秒）。 - 二：
.cargo/config.toml里replace-with指向上表镜像，registry = "sparse+..."。 - 三：先
cargo fetch --locked再编译，失败可单独重试该步。 - 四：缓存注册表、git 源与
target，键含镜像名与rustc -V。 - 五：合并请求禁止私改源，审
config.toml差异。
env:
CARGO_NET_RETRY: "10"
CARGO_HTTP_TIMEOUT: "600"
与 Git 拉子模块拆成独立步骤时，cargo 失败可单独重试，不必整仓重跑，节省远程 Mac 分钟数。
超时、证书与代理 FAQ
问：换镜像仍超时？ 答：加上述两环境变量；先 fetch 再 build；查代理是否掐空闲连接。
问：解密代理证书失败？ 答：导入企业根证书；必要时设 CURL_CA_BUNDLE；慎用降低校验开关并留审计记录。
问：代理变量？ 答：常用 HTTPS_PROXY、HTTP_PROXY；团队格式写死。延伸阅读跨境拉取加速对比。
与 Git 子模块、monorepo 并存的注意
- workspace：共享根
Cargo.lock时缓存以仓库根为准。 - 子模块：子仓有锁则分别
cargo fetch --locked，缓存键带子模块提交。 - 大仓：先稳 Git 再 cargo；出口尽量统一；远程 Mac 预留磁盘给大体量
target。
可引用清单与小结
可引用三条
- 流水线默认带
CARGO_NET_RETRY与CARGO_HTTP_TIMEOUT，再选镜像。 - 统一稀疏镜像与
config.toml，合并前cargo fetch --locked。 - 证书走企业受信链，共享远程机勿堆个人绕过脚本。