Cargo.toml编译配置文件解读

1. #[cfg(not(feature = "debug-validate"))]作用

首先说明一点debug-validate这个名字是用户自定义的，也可以取个其他名字。

[package]
name = "CompileCfgT"
version = "0.1.0"
edition = "2024"
[features]
debug = []
debug-validate = []

#[cfg(not(feature = "debug-validate"))] 是 Rust 中的一个条件编译属性（Conditional Compilation Attribute）。

它的作用是控制其所附着的代码块是否被包含在最终的编译产物中，取决于一个特定的 Cargo Feature 是否被启用。

详细解析

这个属性可以分解为几个部分来理解：

• #[cfg(...)]： 这是一个条件编译指令。括号内的条件决定了它下面的代码是否被编译。
• not(...)： 这是一个逻辑非操作符。它反转了内部条件的真假值。
• feature = "debug-validate"： 这是一个条件，检查在当前的构建配置中，名为 "debug-validate" 的 Cargo Feature 是否被启用了。

综合含义

将这些组合起来，#[cfg(not(feature = "debug-validate"))] 的含义是：

“如果在编译时没有（not）启用名为 debug-validate 的 Cargo Feature，那么就编译它下面的代码。”

使用场景示例

这个属性通常用于在调试模式和发布/性能模式之间切换代码。

假设你有一些额外的验证逻辑或调试日志，这些代码只希望在开发过程中使用，而在最终的生产环境中不希望有任何性能损耗。

Cargo.toml 配置示例：

你需要在你的 Cargo.toml 文件中定义这个 Feature：

 内容如上面的Cargo.toml

Rust 代码示例：

// 只有当 debug-validate 未启用时，才会编译这个函数
#[cfg(not(feature = "debug-validate"))]
pub fn run_fast_validation() {println!("使用快速生产验证（debug-validate feature 未启用）");// 实际的生产环境高效代码
}// 只有当 debug-validate 启用时，才会编译这个函数
#[cfg(feature = "debug-validate")]
pub fn run_debug_validation() {println!("使用慢速调试验证（debug-validate feature 已启用）");// 包含大量断言和日志的调试代码
}fn main() {run_fast_validation();// run_debug_validation() 如果未启用 feature，调用这行会编译错误
}

编译，启用时加“--features debug-validate”：

cargo build --features debug-validate

总结

#[cfg(not(feature = "debug-validate"))] 是一种强大的方式，让你可以在不修改源代码的情况下，通过改变编译选项（Cargo Features），在性能和调试能力之间进行切换。