第2章库 on 编程那些事儿

01-互操作性

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

译文 · 基于 Pragmatic Rust Guidelines

原文链接: https://microsoft.github.io/rust-guidelines/guidelines/libs/interop/index.html

互操作性

类型是 Send (M-TYPES-SEND)

本条守护：可在 Tokio 中使用，以及置于运行时抽象之后。

公开类型出于兼容性应当是 Send：

所产生的全部 future（无论显式还是隐式）必须是 Send
其他大多数类型也应当是 Send，但可能有例外

Future

当显式声明 future 时，你应当确保它是、并且一直保持为 Send。

02-用户体验

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

译文 · 基于 Pragmatic Rust Guidelines

原文链接: https://microsoft.github.io/rust-guidelines/guidelines/libs/ux/index.html

用户体验

抽象不要明显嵌套 (M-SIMPLE-ABSTRACTIONS)

本条守护：低认知负荷与良好的开箱即用 UX。

设计公共类型与主要 API 面时，避免向用户暴露嵌套或复杂的参数化类型。

03-韧性

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

译文 · 基于 Pragmatic Rust Guidelines

原文链接: https://microsoft.github.io/rust-guidelines/guidelines/libs/resilience/index.html

韧性

I/O 与系统调用可被 mock (M-MOCKABLE-SYSCALLS)

本条守护：否则难以触发的边界情况也可测试。

任何面向用户、会做 I/O 或带副作用的系统调用的类型，都应能 mock 这些副作用。这包括文件和网络访问、时钟、熵源与种子，以及类似事物。更一般地说，任何满足以下条件的操作都应当可被 mock：

04-构建

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

译文 · 基于 Pragmatic Rust Guidelines

原文链接: https://microsoft.github.io/rust-guidelines/guidelines/libs/building/index.html

构建

库开箱即用 (M-OOBE)

本条守护：在整个 Rust 生态中易于采用。

库必须在所有受支持平台上开箱即用，明确声明为平台或目标特定的库除外。

Rust crate 常常带有几十个依赖，应用则有上百个。用户期望 cargo build 和 cargo install 直接能用。看看安装 bat 时拉入约 250 个依赖的情形：

第2章 库 on 编程那些事儿

01-互操作性

互操作性

类型是 Send (M-TYPES-SEND)

Future

02-用户体验

用户体验

抽象不要明显嵌套 (M-SIMPLE-ABSTRACTIONS)

03-韧性

韧性

I/O 与系统调用可被 mock (M-MOCKABLE-SYSCALLS)

04-构建

构建

库开箱即用 (M-OOBE)

第2章库 on 编程那些事儿