Rust多可执行文件库crate的文件布局及模块引用问题

放心，你设想的这种布局完全可行，而且这正是处理复杂二进制 crate 专属代码拆分的标准做法之一。我来一步步给你讲清楚怎么实现，还有一些实用的小技巧。

第一步：搭建目录结构 #

先给你一个清晰的目录示例，你可以照着这个来：

your-rust-project/
├── Cargo.toml
├── src/
│   ├── lib.rs       # 所有二进制共享的库代码
│   └── common/      # 共享库的子模块（可选，按需拆分）
│       └── mod.rs
└── src/bin/
    ├── firstbin/
    │   ├── mod.rs   # firstbin 专属模块的入口文件
    │   ├── utils.rs # firstbin 独有的工具函数
    │   └── business.rs # firstbin 专属业务逻辑
    ├── firstbin.rs  # firstbin 二进制程序的入口（main函数在这里）
    ├── secondbin/
    │   ├── mod.rs
    │   ├── helper.rs
    │   └── core.rs
    └── secondbin.rs # secondbin 二进制程序的入口

第二步：引用专属模块的代码 #

以firstbin为例，要在入口文件firstbin.rs里引用firstbin/目录下的代码，只需要两步：

1. 确保firstbin/mod.rs存在（哪怕是空文件也行，它的作用是标记这个目录是一个Rust模块）。如果要导出目录里的子模块，直接在mod.rs里声明就行：

// src/bin/firstbin/mod.rs
pub mod utils;
pub mod business;

2. 在firstbin.rs里声明这个本地模块，然后就可以自由引用里面的代码了：

// src/bin/firstbin.rs
// 声明firstbin模块，对应同级的firstbin/目录
mod firstbin;

// 按需引入模块里的内容
use firstbin::utils::format_log;
use firstbin::business::process_task;

fn main() {
    format_log("Starting firstbin...");
    let result = process_task();
    println!("Task result: {}", result);
}

关于布局的额外建议 #

如果你的二进制程序后续变得非常庞大，甚至需要独立的依赖或配置，也可以考虑把每个二进制程序拆成workspace的独立成员——比如在项目根目录下创建firstbin/和secondbin/两个子目录，各自拥有自己的Cargo.toml，然后用根目录的Cargo.toml把它们和共享库组成workspace。不过对于大多数场景来说，你最开始设想的src/bin/下建子目录的方式已经足够简洁高效，不需要过度拆分。

另外，Rust 2018及以后的版本支持省略mod.rs，改用firstbin.rs作为模块入口，但在你的场景里，因为二进制入口已经叫firstbin.rs了，所以还是用子目录+mod.rs的方式更不容易混淆。

总的来说，你这个思路完全正确，这种布局既清晰分离了共享代码和专属代码，又能让每个二进制程序的内部结构一目了然，是处理这类场景的最优选择之一。

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