如何基于feature条件配置Cargo.toml中的crate-type字段？

一、如何根据feature条件设置crate-type #

Cargo.toml本身不支持直接通过cfg(feature)语法条件配置[lib]字段，你可以通过以下两种方式实现需求：

1. 使用build.rs动态指定crate类型 #

在项目根目录创建build.rs文件，通过检测启用的feature，向Cargo传递编译指令：

fn main() {
    // 根据启用的feature设置对应的crate类型
    if cfg!(feature = "a") {
        println!("cargo:rustc-crate-type=staticlib");
    } else if cfg!(feature = "b") {
        println!("cargo:rustc-crate-type=rlib");
    }
}

然后在Cargo.toml中移除原有的[lib]配置（或保留默认值，build.rs的指令会覆盖它）。编译时只需指定对应feature即可：

• 启用feature a编译staticlib：cargo build --features a
• 启用feature b编译rlib：cargo build --features b

2. 通过环境变量配合Cargo.toml配置 #

在Cargo.toml中使用环境变量占位符：

[lib]
crate-type = ["${CRATE_TYPE}"]

编译时手动设置环境变量并指定feature：

• 编译staticlib：CRATE_TYPE=staticlib cargo build --features a
• 编译rlib：CRATE_TYPE=rlib cargo build --features b

这种方式需要用户手动输入环境变量，灵活性不如build.rs方案。

二、同时编译rlib和staticlib时体积暴增的原因 #

这不是Cargo的bug，而是两种crate类型的设计目标差异导致的：

• rlib：专为Rust生态设计，包含大量Rust内部使用的元数据、泛型实例、以及供其他Rust crate调用的完整API符号，1.5MB左右的体积是正常状态。
• staticlib：专为FFI场景设计，编译时会进行严格的死代码消除，只保留对外暴露的C兼容符号和必要代码，700KB左右的体积是优化后的结果。

当同时指定两种crate-type时，Cargo需要同时满足两种编译目标的需求：staticlib会被迫包含rlib中的所有元数据、Rust专属符号和未被消除的代码，导致最终的staticlib体积急剧膨胀。此外，双重编译目标可能会干扰Cargo的优化策略，进一步加剧体积问题。

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