02-深入主题 on 编程那些事儿

01-信号处理

Sat, 01 Aug 2026 10:33:00 +0800

译文 · 基于 Command Line Applications in Rust

信号处理

原文链接: https://rust-cli.github.io/book/in-depth/signals.html

像命令行应用这样的进程，需要响应操作系统发来的信号。最常见的例子大概是 Ctrl+C，这个信号通常表示让进程终止。在 Rust 程序中处理信号时，你需要考虑如何接收这些信号，以及如何对它们做出反应。

02-使用配置文件

Sat, 01 Aug 2026 10:33:00 +0800

译文 · 基于 Command Line Applications in Rust

使用配置文件

原文链接: https://rust-cli.github.io/book/in-depth/config-files.html

处理配置可能会很烦人，尤其是当你要支持多种操作系统，而它们各自对短期与长期文件有不同存放位置时。

对此有多种解决方案，有些比另一些更底层。

03-退出码

Sat, 01 Aug 2026 10:33:00 +0800

译文 · 基于 Command Line Applications in Rust

退出码

原文链接: https://rust-cli.github.io/book/in-depth/exit-code.html

程序并不总能成功。出错时，你应确保正确发出必要的信息。除了向用户报告错误之外，在大多数系统上，进程退出时还会发出一个退出码（0 到 255 之间的整数与大多数平台兼容）。你应尽量按程序状态发出正确的退出码。例如，在理想情况下程序成功时，应以 0 退出。

04-与人沟通

Sat, 01 Aug 2026 10:33:00 +0800

译文 · 基于 Command Line Applications in Rust

与人沟通

原文链接: https://rust-cli.github.io/book/in-depth/human-communication.html

请先阅读教程中的 CLI 输出一章。那一章讲如何向终端写入输出，而本章讨论的是要输出什么。

一切正常时

即使一切正常，报告应用进度也很有用。这些消息应尽量信息充分且简洁。日志里不要用过于技术化的术语。记住：应用并没有崩溃，用户没有理由去查找错误。

05-与机器沟通

Sat, 01 Aug 2026 10:33:00 +0800

译文 · 基于 Command Line Applications in Rust

与机器沟通

原文链接: https://rust-cli.github.io/book/in-depth/machine-communication.html

命令行工具的真正威力，在你能把它们组合起来时才会显现。这并不是新想法：事实上，Unix 哲学里有这样一句话：

期望每个程序的输出都能成为另一个（尚且未知的）程序的输入。

06-为 CLI 应用生成文档

Sat, 01 Aug 2026 10:33:00 +0800

译文 · 基于 Command Line Applications in Rust

为 CLI 应用生成文档

原文链接: https://rust-cli.github.io/book/in-depth/docs.html

CLI 的文档通常包括命令中的 --help 部分，以及一份手册（man）页。

两者都可以在使用 clap 时通过 clap_mangen crate 自动生成。

1
2
3
4
5
6
7
8


#[derive(Parser)]
pub struct Head {
 /// 要加载的文件
 pub file: PathBuf,
 /// 要打印多少行
 #[arg(short = "n", default_value = "5")]
 pub count: usize,
}

其次，你需要使用 build.rs，在编译时根据代码中对应用的定义生成手册文件。