如何通过Rust特性标志动态控制工作区crate的编译？

问题背景 #

项目结构如下：

- main_crate (features = "x")
  - driver_crate (features = "x")
    - x_crate
  ...

main_crate/Cargo.toml配置：

[features]
x = ["driver-crate/x"]

# default = ["x"]

driver_crate/Cargo.toml配置：

[dependencies]
x-crate = { path = "../x-crate", optional = true }

[features]
x = ["dep:x-crate"]

执行cargo build --no-default-features时，尽管x_crate不在main_crate的依赖树中，但因为工作区虚拟清单设置了members = ["src/*"]，自动将x_crate纳入工作区成员，导致Cargo仍会编译它。需要通过工作区特性x动态控制x_crate是否参与编译。

解决方案 #

方法1：使用条件工作区成员（推荐，Cargo 1.64+）

Cargo 1.64及以上支持条件工作区成员，可以直接通过工作区特性控制是否将x_crate纳入工作区。修改根目录的虚拟Cargo.toml：

[workspace]
# 固定包含核心crate
members = [
  "src/main_crate",
  "src/driver_crate",
]
# 仅当特性x启用时，才将x_crate作为工作区成员
members = [{ path = "src/x_crate", optional = true }]

[features]
# 定义工作区特性x，启用时激活x_crate的工作区成员属性
x = ["dep:x_crate"]

使用方式：

• 禁用默认特性时：cargo build --no-default-features，此时x_crate不属于工作区成员，不会被编译
• 启用特性x时：cargo build --features x，x_crate会被纳入工作区，同时配合子crate的特性传递完成编译

方法2：手动指定工作区成员（兼容旧版Cargo）

如果你的Cargo版本低于1.64，无法使用条件成员，可以放弃通配符，手动列出工作区核心成员，不默认包含x_crate：
修改根Cargo.toml：

[workspace]
members = [
  "src/main_crate",
  "src/driver_crate",
]

需要编译x_crate时，手动指定目标：

cargo build --features x -p main_crate -p x_crate

方法3：通过exclude字段配合特性条件（备选）

利用Cargo的条件排除功能，在特性未启用时将x_crate排除出工作区：

[workspace]
members = ["src/*"]
# 当特性x未启用时，排除x_crate
exclude = [
  { path = "src/x_crate", condition = "not(feature = 'x')" }
]

[features]
x = []

注意事项 #

• 确认Cargo版本：条件成员和条件排除需要Cargo 1.64及以上，可通过cargo --version检查
• 保持特性逻辑一致：工作区特性x要和子crate的特性x逻辑对齐，避免依赖关系冲突

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