如何在Cargo.toml中为Rust库实现条件编译的替代方案？

我有一个在Cargo.toml中定义的Rust库：

[lib]
path = "src/lib.rs"

我还有一个针对Linux系统的替代实现文件src/lib_linux.rs，希望通过Cargo.toml的cfg关键字进行条件编译，尝试写法如下：

[lib.'cfg(not(target_os = "linux"))']
path = "src/lib.rs"

[lib.'cfg(target_os = "linux")']
path = "src/lib_linux.rs"

但在当前Rust 1.74.0版本中，无法在Cargo.toml的lib部分使用cfg关键字。我不想在src/lib.rs中使用cfg(target_os = "linux")进行条件编译（会产生大量重复代码），请问有什么解决方案？

方案一：用#[path]属性条件导入入口模块 #

保持Cargo.toml的[lib]配置不变，只指向src/lib.rs，然后在这个入口文件里做转发，通过条件编译切换实际的实现文件：

// src/lib.rs
#[cfg(target_os = "linux")]
#[path = "lib_linux.rs"]
mod actual_lib;

#[cfg(not(target_os = "linux"))]
#[path = "lib_non_linux.rs"] // 把原来src/lib.rs里的通用实现移到这个文件
mod actual_lib;

pub use actual_lib::*;

这样入口文件只负责转发逻辑，不会有重复代码，实际实现分别放在对应系统的文件里。

方案二：利用Cargo特性自动切换实现 #

在Cargo.toml里定义特性，并绑定到目标系统，自动切换lib路径：

[lib]
path = "src/lib.rs" # 默认通用实现

[features]
linux_impl = []

# 针对Linux目标自动启用特性
[target.'cfg(target_os = "linux")'.features]
linux_impl = []

# 启用linux_impl特性时，切换到Linux专属实现
#[cfg(feature = "linux_impl")]
[lib]
path = "src/lib_linux.rs"

编译时无需手动指定特性，Cargo会根据目标系统自动选择对应的实现文件。

方案三：用构建脚本生成入口文件 #

编写build.rs脚本，根据目标系统动态生成转发用的入口文件：

// build.rs
use std::env;
use std::fs::File;
use std::io::Write;
use std::path::Path;

fn main() {
    let target_os = env::var("CARGO_CFG_TARGET_OS").unwrap();
    let out_dir = env::var("OUT_DIR").unwrap();
    let dest_path = Path::new(&out_dir).join("lib.rs");
    let mut f = File::create(&dest_path).unwrap();

    if target_os == "linux" {
        writeln!(f, "mod lib_linux; pub use lib_linux::*;").unwrap();
    } else {
        writeln!(f, "mod lib_non_linux; pub use lib_non_linux::*;").unwrap();
    }

    println!("cargo:rustc-lib-path={}", out_dir);
}

然后修改Cargo.toml的lib配置指向生成的文件：

[lib]
path = "{env:OUT_DIR}/lib.rs"

构建时脚本会自动根据目标系统生成对应的转发入口，完全无需手动干预。

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