如何将Rust工作区的成员库配置为可按特性引入？

要实现把工作区成员库作为特性按需引入的需求，你需要在工作区中新增一个根库 crate作为统一入口，通过特性控制各个成员库的启用，具体步骤如下：

1. 修改工作区的Cargo.toml #

在原有工作区配置基础上，添加根库的包定义、可选依赖和特性映射：

[package]
name = "my_workspace"
version = "0.1.0"
edition = "2021"
publish = false # 不需要发布到crates.io时建议添加

[workspace]
members = [
    "my_lib_1",
    "my_lib_2",
    "my_lib_3",
    ...
]

# 将所有成员库设为可选依赖
[dependencies]
my_lib_1 = { path = "./my_lib_1", optional = true }
my_lib_2 = { path = "./my_lib_2", optional = true }
my_lib_3 = { path = "./my_lib_3", optional = true }

# 定义特性与成员库的映射
[features]
default = [] # 默认不启用任何成员库
my_lib_1 = ["dep:my_lib_1"]
my_lib_2 = ["dep:my_lib_2"]
my_lib_3 = ["dep:my_lib_3"]
# 支持组合特性，比如一次性启用所有库：
# full = ["my_lib_1", "my_lib_2", "my_lib_3"]

2. 创建根库入口文件src/lib.rs #

在工作区根目录新建src文件夹，创建lib.rs文件，将启用的成员库导出到根库命名空间：

// 仅当对应特性启用时，导出成员库
#[cfg(feature = "my_lib_1")]
pub use my_lib_1;

#[cfg(feature = "my_lib_2")]
pub use my_lib_2;

#[cfg(feature = "my_lib_3")]
pub use my_lib_3;

3. 依赖方的使用方式 #

现在其他包就能按照你期望的方式引入和使用：

Cargo.toml配置 #

[dependencies]
my_workspace = { path = "../path/to/my_workspace", features = ["my_lib_1"] }

代码中调用 #

use my_workspace::my_lib_1;

fn do_something() {
    my_lib_1::whatever_that_exposes_this_lib();
}

注意事项 #

• 根库的publish = false可以避免误发布到crates.io，若需要发布，需确保所有成员库的发布配置也正确。
• 如果成员库之间存在依赖关系，可以在特性中自动关联，比如my_lib_3 = ["dep:my_lib_3", "my_lib_1"]，启用my_lib_3时会自动带上my_lib_1。
• 工作区的members列表无需包含根库，Cargo会自动识别当前目录的crate。

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