如何更简洁地组织单命令对应单文件的Rust CLI库？

我最近在折腾一个Rust CLI项目，想实现一个命令对应一个文件的结构，这样后续维护和新增命令都会更清爽。理想中的目录结构大概是这样的：

├── src
│   ├── commands
│   │   └── echo.rs
│   ├── commands.rs
│   ├── lib.rs
│   └── main.rs

原本我以为能直接像 mycli::commands::echo(str, std::io::stdout()); 这样调用命令，但实际实现时绕了不少弯路，后来摸索出几个更简洁的组织方式，分享给你：

基础简洁实现 #

1. 编写单个命令文件：在 src/commands/echo.rs 里定义命令的核心逻辑，记得用pub对外暴露函数：

use std::io::Write;

pub fn echo(input: &str, out: &mut impl Write) -> std::io::Result<()> {
    writeln!(out, "{}", input)?;
    Ok(())
}

2. 统一导出命令模块：在 src/commands.rs 里声明所有命令模块，新增命令时只需要加一行即可：

pub mod echo;
// 以后加新命令比如`list`，就加一行 `pub mod list;`

3. 暴露库级模块：在 src/lib.rs 里把commands模块对外暴露，这样bin目录的main.rs能引用到：

pub mod commands;

4. 在main中调用命令：现在在 src/main.rs 里就能直接引用并调用了：

use mycli::commands::echo;
use std::io;

fn main() -> io::Result<()> {
    echo::echo("Hello Rust CLI!", &mut io::stdout())?;
    Ok(())
}

更进一步：简化调用路径 #

如果觉得每次写echo::echo有点繁琐，可以在 src/commands.rs 里直接重导出命令函数：

pub use echo::echo;
// 新增命令时同步加一行 `pub use list::list;`

这样在main.rs里就能直接调用函数，不用再嵌套一层模块：

use mycli::commands::echo;
use std::io;

fn main() -> io::Result<()> {
    echo("Hello Simplified!", &mut io::stdout())?;
    Ok(())
}

额外小提示 #

• 如果多个命令需要共享通用逻辑（比如参数解析、错误处理模板），可以在commands目录下新增common.rs，把通用代码放在这里，其他命令模块通过super::common引用即可。
• 要是用clap这类主流CLI框架，还可以把每个命令的配置（比如参数定义、子命令注册）也放在对应文件里，然后在commands.rs统一收集，最后在main函数里组装整个CLI，结构会更清晰。

备注：内容来源于stack exchange，提问作者EmptyArsenal