能否为Rust示例配置专属build.rs文件？

核心结论 #

Cargo不支持为单个[[example]]配置专属的build.rs文件——你在[[example]]区块中添加的build字段并非合法配置项，因此会被Cargo直接忽略。

正确处理方式 #

针对示例需要独立编译.proto文件的场景，有几种实用的解决方案：

1. 根目录build.rs条件编译（推荐）

保留你当前的结构，但优化根build.rs的逻辑，仅在构建目标示例时才编译.proto文件，避免主库构建时做无用功。通过读取环境变量CARGO_BIN_NAME判断当前是否在构建目标示例：

fn main() {
    // 仅当构建x1示例时执行proto编译
    if std::env::var("CARGO_BIN_NAME").unwrap_or_default() == "x1" {
        // 替换为你实际使用的proto编译工具（如tonic-build、prost-build）
        tonic_build::compile_protos("examples/x1/my_proto.proto").unwrap();
    }
}

示例中依然可以用你原来的方式引入生成的代码：

pub mod my_proto {
    include!(concat!(env!("OUT_DIR"), "/my_proto.rs"));
}

2. 将示例转为独立子crate

把需要独立构建逻辑的示例拆成一个完整的二进制crate，放在examples/x1目录下，结构如下：

examples/
└── x1/
    ├── Cargo.toml
    ├── build.rs
    ├── src/
    │   └── main.rs
    └── my_proto.proto

在这个子crate的Cargo.toml中正常配置build = "build.rs"，编译时可以直接执行cargo build --package x1，或进入该目录运行cargo build。这种方式完全隔离了示例的构建逻辑，但需要单独维护子crate与主库的依赖版本。

3. 结合特征（Feature）控制编译

在主库的Cargo.toml中为目标示例关联专属特征，然后在根build.rs中根据特征是否启用决定是否编译proto：

# 主库Cargo.toml
[[example]]
name = "x1"
path = "examples/x1/main.rs"
features = ["build-x1-proto"]

[features]
build-x1-proto = []

根build.rs中添加条件判断：

fn main() {
    if cfg!(feature = "build-x1-proto") {
        tonic_build::compile_protos("examples/x1/my_proto.proto").unwrap();
    }
}

构建示例时Cargo会自动启用关联的特征，触发proto编译。

内容的提问来源于stack exchange，提问作者C.M.