Rust Cargo使用指南 | 第十五篇 | 配置config.toml
最新回答
纸墨清香
2025-03-02 08:05:42
本文聚焦于如何配置Cargo工具，某些配置项可能覆盖Cargo.toml中的对应部分，例如关于profile的内容。
Cargo的配置遵循层级结构，从当前目录向上查找配置文件。在目录`/projects/foo/bar/baz`下执行命令时，查找路径为`/projects/foo/bar/baz`。
全局配置设置于`$HOME/.cargo/config.toml`，也可在每个包内自定义配置。这样既可设置全局默认配置，又能针对每个包进行独立调整，并实现版本控制。
多个配置文件中出现相同key时，Cargo会优先使用最近的配置文件中的值。如果值为数组，会合并各个配置文件中的对应值。
工作空间下，Cargo从根目录开始查找配置，内部成员的`.cargo.toml`文件会被忽略。因此，工作空间拥有两个成员时，Cargo不会读取成员的配置文件。
Cargo支持`.cargo/config`文件，且从Rust 1.39版本开始支持`.toml`后缀。优先级上，`.toml`文件高于无后缀文件。
配置文件示例包含常用选项的翻译，可作为参考。例如，环境变量`CARGO_FOO_BAR`对应配置文件中的`foo.bar`，转换规则为将`.`和`-`替换为`_`，且将字母转换为大写。
环境变量优先级高于配置文件，且支持预定义环境变量。了解更多内容可查阅官方Cargo Book，但大多数用户无需关注其中的详细信息。
本文由RustTT翻译小组翻译，原始内容发布于：Introduction - The Cargo Book。
热门标签
