修改 Cargo 依赖源不需要编辑 Cargo.toml，而是需要在项目根目录或用户目录下创建.cargo/config.toml 文件并配置 registry 地址。

此方法适用于中国大陆地区网络环境下解决 crates.io 下载超时或速度过慢的问题，风险边界在于配置错误可能导致 cargo 命令无法拉取依赖。

命令速用版

在项目根目录或用户主目录下创建.cargo/config.toml 文件，写入以下配置内容：

[source.crates-io]
replace-with = 'rsproxy-sparse'

[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/crates.io-index/"

[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index/"

[net]
git-fetch-with-cli = true

或者使用清华大学开源软件镜像站配置：

[source.crates-io]
replace-with = 'tuna'

[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

为什么会这样

Cargo 默认从官方 crates.io 仓库拉取依赖，该仓库服务器位于海外，中国大陆地区直接访问存在较高的网络延迟和连接重置风险。

修改配置源是将下载请求重定向到国内同步镜像服务器，物理距离更近且网络链路优化，从而减少连接超时和下载失败的概率。此操作仅改变依赖下载路径，不改变依赖版本和内容哈希校验。

分步处理

1. 确定配置文件位置：优先在项目根目录创建.cargo/config.toml，仅影响当前项目；若在用户主目录（~/.cargo/config.toml）创建，则影响所有 Rust 项目。

2. 创建目录与文件：在目标路径下新建.cargo 文件夹，若已存在则直接进入，新建 config.toml 文件。

3. 写入配置内容：复制上述“命令速用版”中的配置片段，确保 TOML 语法格式正确，无多余字符。

4. 保存并清理缓存：保存文件后，可执行 cargo clean 清理旧缓存，避免混合源导致校验错误。

怎么验证是否生效

执行 cargo build -v 或 cargo update -v 命令，观察终端输出日志。

检查 Downloading 行后的 URL 地址，若显示 mirrors.tuna.tsinghua.edu.cn 或 rsproxy.cn 等国内域名，即表示配置生效。

若仍显示 https://github.com/rust-lang/crates.io-index 或 crates.io，则配置未加载或优先级被覆盖。

常见坑

1. 文件名错误：配置文件必须名为 config.toml，旧版本 cargo 支持 config 无后缀，但建议使用标准后缀。

2. 路径层级错误：.cargo 文件夹需与 Cargo.toml 同级，或在用户主目录下，随意放置无法被识别。

3. 多配置冲突：若同时存在项目级和用户级配置，项目级配置优先，需注意两者内容是否冲突。

4. 稀疏协议支持：部分旧版本 cargo 不支持 sparse 协议，若报错可改用 git 索引配置方式。

常见问题

修改后 cargo 命令报错无法解析怎么办？

检查.toml 文件语法是否有误，确保键值对格式正确，无隐藏字符。

如何恢复默认官方源配置？

删除或重命名.cargo/config.toml 文件，cargo 将自动回退至默认官方源设置。

公司内网有私有源如何配置？

在 config.toml 中新增 [registries.private-registry] 段落，指定内网索引地址并配置 token。

参考来源

• Rust Cargo Reference: Config - https://doc.rust-lang.org/cargo/reference/config.html
• 清华大学开源软件镜像站：crates.io 帮助 - https://mirrors.tuna.tsinghua.edu.cn/help/crates.io/