如何在Cargo.toml中指定target_os限制仅特定平台编译

不需要为每段代码单独添加#[cfg(target_os = "linux")]属性，两种低配置成本的方案可以直接实现全crate的平台编译限制：

• 根入口全局拦截（最推荐，改造成本最低）
  直接在crate根入口文件（库crate对应src/lib.rs，二进制crate对应src/main.rs）的最顶部添加如下crate级条件编译属性：

// 非Linux平台直接触发编译错误，终止编译流程
#![cfg(not(target_os = "linux"))]
compile_error!("This crate can only be compiled on Linux");

配置完成后，非Linux环境下编译会直接抛出预设的错误信息终止流程，crate内其余所有业务代码、子模块都不需要额外添加任何条件编译属性，原有业务逻辑不需要做任何修改。Linux环境下该属性不会生效，crate正常编译。
你之前使用的平台专属依赖配置[target.'cfg(target_os = "linux")'.dependencies]可以正常保留，非Linux环境下不会拉取、编译这些专属依赖。

• build.rs 前置拦截（拦截时机更早）
  如果需要在编译流程最早期就终止非目标平台的编译，可以在项目根目录新建build.rs构建脚本，写入如下内容：

fn main() {
    let target_os = std::env::var("CARGO_CFG_TARGET_OS").expect("Failed to get target os info");
    if target_os != "linux" {
        panic!("This crate only supports Linux platform, compilation terminated");
    }
}

构建脚本会在整个crate源码编译前执行，非Linux环境下会直接panic终止流程，不会进入后续的依赖解析、源码编译阶段。

你之前查到的逐段代码添加cfg属性、分平台配置依赖的方案，仅适用于跨平台crate中部分模块、依赖需要按平台启用的场景，对于全crate仅支持单平台的需求，不需要使用这种高操作成本的写法。

内容的提问来源于stack exchange，提问作者洪古格