01-15 分钟写出一个命令行应用

从零构建一个简单的 CLI 工具教程

译文 · 基于 Command Line Applications in Rust

15 分钟写出一个命令行应用

原文链接: https://rust-cli.github.io/book/tutorial/index.html

本教程将引导你用 Rust 编写一个 CLI(命令行界面)应用。 大约十五分钟后, 你就能得到一个可以运行的程序 (大约到第 1.3 章)。 之后我们会继续打磨这个程序, 直到可以发布这款小工具。

你会学到起步所需的全部要点, 以及去哪里查找更多信息。 觉得暂时用不到的部分可以跳过, 也可以从任意位置切入。

你想写什么样的项目? 不妨从简单的开始: 我们来写一个小型的 grep 克隆。 也就是:给它一个字符串和一条路径, 它就只打印包含该字符串的那些行。 我们把它叫做 grrs(读作 “grass”)。

最终, 我们希望能这样运行这个工具:

1
2
3
4
5
6
7
8
$ cat test.txt
foo: 10
bar: 20
baz: 30
$ grrs foo test.txt
foo: 10
$ grrs --help
[some help text explaining the available options]

01-项目准备

用 Cargo 创建 CLI 项目

02-解析命令行参数

解析 CLI 参数(含 clap)

03-第一次实现

实现第一版 grep 风格工具

04-更友好的错误报告

改进 CLI 错误处理与报告

05-面向人与机器的输出

人类可读输出与机器可解析输出

06-测试

为 CLI 应用编写测试

07-打包与分发 Rust 工具

打包并分发 Rust CLI 工具

最后修改 August 11, 2026: 更新 (70a5af133)