第1章惯用法 on 编程那些事儿

01-参数使用借用类型

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/coercion-arguments.html

参数使用借用类型

描述

在决定函数参数使用何种类型时，以解引用强制转换（deref coercion）的目标类型作为参数，可以提高代码的灵活性。这样，函数就能接受更多的输入类型。

02-用 format! 拼接字符串

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/concat-format.html

用 format! 拼接字符串

描述

可以用可变 String 上的 push 和 push_str 方法，或使用它的 + 运算符来逐步构建字符串。不过，使用 format! 通常更方便，尤其是在字面量字符串与非字面量字符串混用的场合。

03-构造器

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/ctor.html

构造器

描述

Rust 没有作为语言构造的构造器。约定是使用关联函数 new 来创建对象：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


/// 以秒计的时间。
///
/// # 示例
///
/// ```
/// let s = Second::new(42);
/// assert_eq!(42, s.value());
/// ```
pub struct Second {
 value: u64,
}

impl Second {
 // 构造 [`Second`] 的新实例。
 // 注意这是关联函数——没有 self。
 pub fn new(value: u64) -> Self {
 Self { value }
 }

 /// 返回以秒为单位的值。
 pub fn value(&self) -> u64 {
 self.value
 }
}

默认构造器

Rust 通过 Default trait 支持默认构造器：

04-Default Trait

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/default.html

Default Trait

描述

Rust 中许多类型都有构造器。不过，这是类型特有的；Rust 无法对「一切带有 new() 方法的东西」进行抽象。为了允许这种抽象，人们构想了 Default trait，它可用于容器和其他泛型类型（例如参见 Option::unwrap_or_default()）。值得注意的是，一些容器在适用处已经实现了它。

05-集合是智能指针

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/deref.html

集合是智能指针

描述

使用 Deref trait，把集合当作智能指针来对待，从而提供数据的所有权视图和借用视图。

示例

use std::ops::Deref;

struct Vec<T> {
 data: RawVec<T>,
 //..
}

impl<T> Deref for Vec<T> {
 type Target = [T];

 fn deref(&self) -> &[T] {
 //..
 }
}

Vec<T> 是 T 的所有权集合，而切片（&[T]）是 T 的借用集合。为 Vec 实现 Deref 允许从 &Vec<T> 到 &[T] 的隐式解引用，并把这种关系纳入自动解引用搜索。你可能期望为 Vec 实现的大多数方法，实际上是为切片实现的。

06-析构器中的收尾

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/dtor-finally.html

析构器中的收尾

描述

Rust 没有与 finally 块等价的机制——无论函数以何种方式退出都会执行的代码。取而代之，可以使用对象的析构器来运行必须在退出前执行的代码。

07-`mem::{take(_), replace(_)}`

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/mem-replace.html

`mem::{take(_), replace(_)}`

描述

假设我们有一个 &mut MyEnum，它至少有两个变体： A { name: String, x: u8 } 和 B { name: String }。现在我们想在 x 为零时把 MyEnum::A 改成 B，同时保持 MyEnum::B 不变。

08-栈上动态分发

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/on-stack-dyn-dispatch.html

栈上动态分发

描述

我们可以对多个值进行动态分发，但为此需要声明多个变量，以绑定不同类型的对象。为了按需延长生命周期，我们可以使用延迟条件初始化，如下所示：

10-遍历 Option

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/option-iter.html

遍历 Option

描述

Option 可以看作一个包含零个或一个元素的容器。特别是，它实现了 IntoIterator trait，因此可以用于需要此类类型的泛型代码。

示例

由于 Option 实现了 IntoIterator，它可以作为 .extend() 的参数：

11-向闭包传递变量

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/pass-var-to-closure.html

向闭包传递变量

描述

默认情况下，闭包通过借用捕获其环境。也可以使用 move 闭包来移动整个环境。然而，你常常只想把部分变量移入闭包、给它一份数据的副本、按引用传递，或做其他某种转换。

12-用私有性保证可扩展性

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/priv-extend.html

用私有性保证可扩展性

描述

在少数场景中，库作者可能希望向公开结构体添加公开字段，或向枚举添加新变体，同时不破坏向后兼容性。

Rust 为这个问题提供了两种解决方案：

13-简便的文档初始化

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/rustdoc-init.html

简便的文档初始化

描述

如果在写文档时初始化某个结构体很费功夫，用一个以该结构体为参数的辅助函数把示例包起来会更快。

动机

有时结构体带有多个或复杂的参数，以及若干方法。这些方法各自都应当有示例。

14-临时可变性

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/temporary-mutability.html

临时可变性

描述

常常需要准备并处理一些数据，但之后这些数据只会被查看、不会再被修改。把可变变量重新定义为不可变，可以把这一意图表达清楚。

15-出错时归还已消耗的参数

Tue, 18 Aug 2026 22:10:00 +0800

译文 · 基于 Rust Design Patterns

原文链接: https://rust-unofficial.github.io/patterns/idioms/return-consumed-arg-on-error.html

出错时归还已消耗的参数

描述

如果一个可能失败的函数会消耗（移动）某个参数，请在错误中把该参数归还回去。

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


pub fn send(value: String) -> Result<(), SendError> {
 println!("using {value} in a meaningful way");
 // 模拟非确定性的可能失败的操作。
 use std::time::SystemTime;
 let period = SystemTime::now()
 .duration_since(SystemTime::UNIX_EPOCH)
 .unwrap();
 if period.subsec_nanos() % 2 == 1 {
 Ok(())
 } else {
 Err(SendError(value))
 }
}

pub struct SendError(String);

fn main() {
 let mut value = "imagine this is very long string".to_string();

 let success = 's: {
 // 尝试发送 value 两次。
 for _ in 0..2 {
 value = match send(value) {
 Ok(()) => break 's true,
 Err(SendError(value)) => value,
 }
 }
 false
 };

 println!("success: {success}");
}

动机

出错时，你可能想尝试其他途径，或者在非确定性函数的情况下重试该操作。但如果参数总是被消耗，你就被迫在每次调用时克隆它，这不太高效。

第1章 惯用法 on 编程那些事儿

01-参数使用借用类型

参数使用借用类型

描述

02-用 format! 拼接字符串

用 format! 拼接字符串

描述

03-构造器

构造器

描述

默认构造器

04-Default Trait

Default Trait

描述

05-集合是智能指针

集合是智能指针

描述

示例

06-析构器中的收尾

析构器中的收尾

描述

07-`mem::{take(_), replace(_)}`

mem::{take(_), replace(_)}

描述

08-栈上动态分发

栈上动态分发

描述

10-遍历 Option

遍历 Option

描述

示例

11-向闭包传递变量

向闭包传递变量

描述

12-用私有性保证可扩展性

用私有性保证可扩展性

描述

13-简便的文档初始化

简便的文档初始化

描述

动机

14-临时可变性

临时可变性

描述

15-出错时归还已消耗的参数

出错时归还已消耗的参数

描述

示例

动机

第1章惯用法 on 编程那些事儿

`mem::{take(_), replace(_)}`