Cargo如何通过特性标志引入整个文件或目录？

控制单个文件 #

你之前用代码块包裹整个文件加属性报错，是因为Rust的属性只能作用于项（item）（比如函数、模块、结构体等），代码块不属于项范畴，所以会触发expected an item after attributes错误。

正确的做法是在文件最顶部添加文件级属性，用#![...]语法（注意感叹号），这个属性会覆盖整个文件的所有内容：

#![cfg(feature = "my-flag")]

// 以下所有代码仅在my-flag开启时编译
use some_crate::SomeType;

pub fn my_optional_function() {
    // ...
}

这样文件里的use语句、函数、结构体等都会自动继承这个编译条件，无需逐个添加#[cfg]标记。

控制整个目录 #

给每个文件单独加属性确实繁琐，更优的方案是把目标目录做成条件编译的子模块：

1. 假设要控制的目录是src/optional/，确保目录内有mod.rs（Rust 2018后可省略，但保留更便于管理）。
2. 在主模块文件（比如lib.rs或main.rs）中，用#[cfg]条件引入这个子模块：

// 仅当my-flag开启时，才编译optional目录下的所有代码
#[cfg(feature = "my-flag")]
pub mod optional;

这样整个optional目录内的所有文件都无需单独添加#[cfg]属性，只要主模块的编译条件满足，整个目录的代码就会被纳入编译流程。

如果目标目录是独立功能模块，还可以配合Cargo.toml的features做联动控制，比如给模块依赖的外部 crate 也加上条件：

[features]
my-flag = ["dep:some_optional_crate"]

[dependencies]
some_optional_crate = { version = "1.0", optional = true }

开启my-flag时，既会编译你的目录代码，也会自动引入对应的外部依赖。

内容的提问来源于stack exchange，提问作者NewToCode