如何通过cargo实现自定义条件编译并传递对应参数

错误原因 #

你使用--feature "lang=en"报错的核心原因是：#[cfg(lang = "xx")]属于自定义Rust条件编译配置项，而--feature参数仅用于传递在Cargo.toml的[features]表中提前声明的功能开关，二者逻辑不匹配。

正确传参方式 #

有两种常用的传参方案：

方案1：通过RUSTFLAGS环境变量直接传递（通用方案） #

直接通过Rust编译器的配置参数--cfg传递自定义配置项，所有cargo子命令都支持这种方式，不需要提前修改Cargo.toml：

• Linux/macOS 环境执行命令：

RUSTFLAGS='--cfg lang="en"' cargo release

• Windows PowerShell 环境执行命令：

$env:RUSTFLAGS='--cfg lang="en"' ; cargo release

• Windows cmd 环境执行命令：

set RUSTFLAGS=--cfg lang="en" && cargo release

如果需要同时传递多个自定义配置项，直接拼接多个--cfg参数即可：

RUSTFLAGS='--cfg lang="en" --cfg region="US"' cargo build

方案2：绑定到Cargo feature（简化命令方案） #

如果想要简化命令输入，避免每次输入长串的RUSTFLAGS，可以提前在Cargo.toml中将自定义配置绑定到feature上：

[features]
# 绑定lang配置到对应的feature
lang_en = ["--cfg", "lang=\"en\""]
lang_fr = ["--cfg", "lang=\"fr\""]

配置完成后就可以直接通过--feature参数传递了：

cargo release --feature lang_en

这种方案更适合团队协作或者对外发布的项目，能避免拼写错误，也方便用户查询支持的配置选项。

注意事项 #

• 如果你使用的是第三方cargo-release插件，建议升级到最新版本，部分旧版本存在环境变量传递异常的问题
• 不同shell的引号转义规则不同，传递字符串类型的cfg值时注意检查引号转义是否正确，避免编译器解析报错

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