Rust项目如何实现二进制与库模式的默认特性差异化？

步骤1：配置Cargo.toml的特性与二进制目标 #

在你的Cargo.toml中做如下修改：

1. 保持默认特性为空，确保cargo add timecat默认仅引入库：

[features]
default = []
# 定义binary特性，包含二进制所需的依赖和功能
binary = [
  "dep:clap", # 示例：二进制用到的CLI依赖
  "dep:anyhow",
  # 其他二进制相关的依赖或内部特性
]

2. 配置二进制目标，声明其依赖binary特性：

[[bin]]
name = "timecat"
path = "src/main.rs"
# 指定该二进制仅在binary特性启用时才会被编译
required-features = ["binary"]

步骤2：条件编译二进制入口 #

在src/main.rs中，用特性条件包裹整个main函数，确保只有启用binary特性时才编译二进制代码：

#[cfg(feature = "binary")]
fn main() {
    // 你的国际象棋引擎二进制逻辑，比如CLI交互、对局启动等
}

步骤3：让cargo install自动启用binary特性 #

为了让用户执行cargo install timecat时自动启用binary特性，在Cargo.toml中添加元数据配置：

[package.metadata.cargo-install]
# 告诉cargo install默认启用binary特性
features = ["binary"]

最终效果 #

• 执行cargo add timecat：默认无任何特性，直接将timecat作为核心库引入项目；
• 执行cargo install timecat：Cargo自动读取元数据配置，启用binary特性，编译并安装二进制可执行文件。

替代方案：拆分库与二进制为工作区子crate #

如果上述方法不符合需求，可彻底分离库和二进制：

1. 创建timecat-lib子crate作为核心库，无默认特性；
2. 创建timecat-bin子crate，依赖timecat-lib并默认启用二进制所需特性；
3. 工作区根目录配置包含两个子crate；
4. 将crates.io上的主发布包设为timecat-bin，同时在README中引导用户若需库，直接添加timecat-lib。此方法需维护两个crate，但能彻底隔离库与二进制的特性配置。

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