Rust 程序如何从其 Cargo 包中访问元数据？

Cargo 通过环境变量将一些元数据传递给编译器，可以在 Cargo documentation pages 中找到其列表。

编译器环境由 Cargo 代码中的 fill_env 填充。自早期版本以来，此代码变得更加复杂，并且整个变量列表不再明显，因为它可以是动态的。但是，至少在此处设置了以下变量（来自 the list in the docs）：

CARGO_MANIFEST_DIR
CARGO_PKG_AUTHORS
CARGO_PKG_DESCRIPTION
CARGO_PKG_HOMEPAGE
CARGO_PKG_NAME
CARGO_PKG_REPOSITORY
CARGO_PKG_VERSION
CARGO_PKG_VERSION_MAJOR
CARGO_PKG_VERSION_MINOR
CARGO_PKG_VERSION_PATCH
CARGO_PKG_VERSION_PRE

您可以使用 env!() 宏访问环境变量。要插入程序的版本号，您可以这样做：

const VERSION: &str = env!("CARGO_PKG_VERSION");

// ...

println!("MyProgram v{}", VERSION);

如果您希望程序在没有 Cargo 的情况下也能编译，您可以使用 option_env!()：

const VERSION: Option<&str> = option_env!("CARGO_PKG_VERSION");

// ...

println!("MyProgram v{}", VERSION.unwrap_or("unknown"));

---

built-crate 有助于在没有所有样板的情况下序列化大量 Cargo 的环境。

---

在构建时（如 build.rs），cargo_metadata 可能有用。例如：

let path = std::env::var("CARGO_MANIFEST_DIR").unwrap();
let meta = MetadataCommand::new()
    .manifest_path("./Cargo.toml")
    .current_dir(&path)
    .exec()
    .unwrap();

let root = meta.root_package().unwrap();
let option = root.metadata["my"]["option"].as_str().unwrap();
let version = &root.version;
...

---