自定义cfg代码生效但Cargo.toml不识别，致依赖导入错误及修改咨询

问题场景 #

通过build.rs读取环境变量MYENV动态设置自定义编译cfgmy_cfg，但Cargo.toml中针对cfg(my_cfg)的依赖未被Cargo识别，编译时出现unresolved import 'inotify'错误。即便rustc已携带--cfg my_cfg参数，对应依赖仍未加载。

解决方案 #

方法1：使用Cargo特性（Features）（推荐）

这是Cargo原生支持的条件依赖方案，可替代自定义cfg：

1. 修改Cargo.toml，添加特性并将依赖设为可选：

[package]
name = "hello"
version = "0.1.0"
edition = "2021"

[features]
# 定义my_cfg特性，启用时自动引入inotify依赖
my_cfg = ["inotify"]

[dependencies]
# 将inotify设为可选依赖，默认不引入
inotify = { version = "0.10.2", optional = true }

2. 修改main.rs，用特性标识替代自定义cfg：

fn main() {
    test()
}

#[cfg(feature = "my_cfg")]
fn test() {
    use inotify::Inotify;
    println!("my_cfg is enabled")
}

#[cfg(not(feature = "my_cfg"))]
fn test() {
    println!("my_cfg is not enabled")
}

3. 运行命令：

• 默认（不启用特性）：cargo run
• 启用my_cfg：cargo run --features my_cfg

若仍想通过环境变量控制，可封装shell脚本简化操作：

if [ "$MYENV" = "my_cfg" ]; then
    cargo run --features my_cfg
else
    cargo run
fi

方法2：环境变量直接关联特性启用

保持Cargo.toml特性配置不变，通过环境变量动态传递特性参数：

MYENV=my_cfg cargo run --features $(echo $MYENV)

原方案失效原因 #

Cargo的依赖解析阶段早于build.rs执行：当Cargo读取Cargo.toml处理依赖时，build.rs尚未运行，因此build.rs设置的自定义cfgmy_cfg在依赖解析时不存在，导致[target.'cfg(my_cfg)'.dependencies]块被忽略，依赖未被引入。

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