Rust语言圣经 on 编程那些事儿

01-关于本书

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「关于本书」

关于本书

Rust 连续多年位居「最受欢迎语言」之列：无 GC、无需手动内存管理、性能接近 C/C++、安全性高、Cargo 生态成熟。但也有人认为「Rust 太难、学了也没用」。

02-进入Rust编程世界

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「进入 Rust 编程世界」

进入 Rust 编程世界

Rust 发展历程

Graydon Hoare 2006 年起在 Mozilla 资助下开发 Rust，2015 年 5 月 15 日发布 1.0。相较 Go（2009 发布、2012 即 1.0），Rust 打磨更久，原因包括：语言特性复杂需全盘权衡、社区意见多元、团队对 1.0 后不可大改的特性极为审慎。

03-避免从入门到放弃

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「避免从入门到放弃」

避免从入门到放弃

Rust 会带来前所未有的编程体验，但入门阶段比 Go/Python 更难：接触所有权、借用、生命周期、智能指针后，难度会陡升。不认真应对，往往只剩「重学」或「放弃」。

04-寻找牛刀，以便小试

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「寻找牛刀，以便小试」

寻找牛刀，以便小试

本章：安装 Rust → 配置 VSCode → 认识 Cargo → 写第一个程序 → 解决依赖下载慢。

安装 Rust 环境

工具：rustup = 安装器 + 版本管理器。推荐唯一安装方式。

平台	命令/步骤
Linux/macOS	`curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf \| sh`
FreeBSD	`pkg install rustup-init` 或 Ports
Windows (msvc)	先装 C++ Build Tools，再运行 `rustup-init.exe`，默认 `x86_64-pc-windows-msvc`
Windows (gnu)	MSYS2 + mingw64，安装时改 host 为 `x86_64-pc-windows-gnu`

链接器报错：需 C 编译器 — macOS: xcode-select --install；Ubuntu: build-essential。

05-Rust基础入门

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Rust 基础入门」

Rust 基础入门

变量绑定与解构

默认不可变；需修改加 mut。

1
2
3


let x = 5; // 不可变
let mut y = 5; // 可变
y = 6;

概念	语法	要点
绑定	`let a = val`	所有权语义，非简单赋值
常量	`const MAX: u32 = 100_000`	必须标注类型；编译期确定；不可 `mut`
遮蔽	`let x = 5; let x = x+1`	新变量，可改类型
忽略未用	`let _x = 5`	前缀 `_` 抑制警告
解构	`let (a, mut b) = (true, false)`	模式匹配提取
解构赋值	`(a, b) = (1, 2)`	1.59+；`+=` 不支持

mut vs shadow：mut 改同一内存；shadow 创建新绑定（可能再分配）。

06-入门实战：文件搜索工具

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「入门实战：文件搜索工具」

入门实战：文件搜索工具

目标：简化版 grep — 从命令行读查询词和文件路径，打印含该词的行。项目名 minigrep。

基本功能

接收命令行参数

1
2


cargo run -- searchstring example-filename.txt
# `--` 后参数传给程序，不是 cargo

1
2
3


use std::env;
let args: Vec<String> = env::args().collect();
// args[0] = 程序路径；args[1] = query；args[2] = file_path

env::args() → 迭代器，collect() → Vec<String>
非 Unicode 参数：env::args_os() → OsString

存储参数与读文件

1
2
3
4
5
6


let query = &args[1];
let file_path = &args[2];

use std::fs;
let contents = fs::read_to_string(file_path)
 .expect("Should have been able to read the file");

搜索并打印

1
2
3
4
5


for line in contents.lines() {
 if line.contains(query) {
 println!("{}", line);
 }
}

最小 main 流程：args → query/file_path → read_to_string → 逐行 contains → println!。

07-Rust高级进阶

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Rust 高级进阶」

Rust 高级进阶

基础已会，本章一带而过细节，聚焦规则与最短示例。

生命周期

生命周期标注引用有效范围；编译器用消除规则推断，搞不定时手动标。

08-进阶实战1：实现一个web服务器

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「进阶实战1: 实现一个 web 服务器」

实践应用：多线程Web服务器

口诀：TCP 监听 → 读 HTTP → 写响应 → 线程池并发 → Drop 优雅关。

多线程非最佳方案；高并发 IO 用 async/tokio（见第 09 章）。

09-进阶实战2：实现一个简单Redis

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「进阶实战2: 实现一个简单 Redis」

进阶实战: 实现一个简单 redis

骨架：#[tokio::main] → TcpListener → spawn 处理连接 → Connection 读写帧 → 共享 Db → channel 客户端。

tokio 概览

异步运行时

reactor：订阅 IO/定时器等事件
executor：调度执行 Future
主流：tokio（生态全）、async-std（贴近 std）、smol（轻量）

tokio 简介

多线程 async 运行时；提供 async 版阻塞 API（如 tokio::time::sleep）
API 名与 std 对齐，同步 fn → 异步 async fn + .await

优势

高性能、行为一致、灵活（单/多线程 runtime）

10-Rust难点攻关

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Rust 难点攻关」

Rust 难点攻关

学至此处，以下概念是否说得清、用得上？

切片 vs 切片引用
String / str / &str 等字符串类型
裸指针 / 引用 / 智能指针（源码待补）
move / Copy / Clone（源码待补）
作用域 / 生命周期 / NLL（源码待补）

本章整理已有解读；标注「待补」的小节见源码目录 shengJing/_src/src/difficulties/。

11-自动化测试

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「自动化测试」

测试

测试可以有效发现缺陷，但无法证明程序不存在缺陷 — Edsger W. Dijkstra

Rust 的类型系统保证类型正确，不能保证逻辑正确。测试通过函数验证行为；不要迷信测试。

12-Cargo使用指南

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Cargo 使用指南」

Cargo 使用指南

Cargo = Rust 包管理 + 构建工具；crates.io 为社区注册中心。本章基于 Cargo Book 整理。

上手使用

Package（项目） ≠ Crate（包）。cargo new hello_world 默认 --bin 二进制项目。

13-企业落地实践

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「企业落地实践」

Rust 的使用案例

Rust 基金会成立后，全球落地案例快速增长。本章通过精选案例说明：Rust 能解决哪些企业痛点，以及落地时可期待的收益。

用 Rust 节约企业成本

参考 AWS 博文：Sustainability with Rust（译文已精简）

14-日志和监控

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「日志和监控」

日志和监控

日志 + 监控是开发实践核心；AIOps 智能化运维依赖海量日志/指标数据分析。

日志详解

日志 = 某时间点向指定位置输出带级别、时间、事件的信息（与语言无关）。

15-Rust最佳实践

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Rust 最佳实践」

Rust 最佳实践

生产级项目重稳定性与可维护性。本章汇总库选型、命名惯例与开发习惯（节选自 Cook Rust）。

日常开发三方库精选

同一类别按推荐度降序；生产项目优先选社区活跃、维护稳定的 crate。

16-手把手带你实现链表

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「手把手带你实现链表」

手把手带你实现链表

其它语言：学语法？写个链表吧。Rust：精通了？写个链表证明一下。

译自 Learning Rust With Entirely Too Many Linked Lists。日常开发请用 Vec / VecDeque / 标准库 LinkedList，本章为教学深坑。

17-征服编译错误

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「征服编译错误」

征服编译错误

两类内容：对抗编译检查（理解报错、改设计）与 Rust 常见陷阱（运行时/语义坑）。

对抗编译检查

生命周期

生命周期过大-01

现象：list.get_interface().noop() 后仍无法 use_list(&list) — cannot borrow as immutable ... borrowed as mutable
根因：get_interface(&'a mut self) 的 'a 与 List<'a> 同寿 → 借用活到 main 结束
修复：引入更短生命周期 'b：fn get_interface<'b>(&'b mut self) -> Interface<'b, 'a> where 'a: 'b
要点：方法签名生命周期≠「这行代码结束就释放」；返回含引用时绑定到参数生命周期

生命周期过大-02

现象：结构体字段间相互引用 + 统一 'a 导致无法拆分借用
根因：一个大 'a 覆盖所有字段引用，编译器认为交叉借用冲突
修复：为不同字段/方法使用独立生命周期参数，约束 where 'long: 'short
要点：「谁借谁、借多久」要分开标注，不要一个 'a 包打天下

循环中的生命周期

现象：loop { arr.len(); let t = &mut arr[i]; return t; } — 双重借用 + 跨迭代 mutable borrow
根因：编译器保守认为 tile 的 mut borrow 延续到整个 '1（含下次循环）；arr.len() 与 &mut arr[i] 冲突
尝试：去掉中间变量仍可能失败（返回引用绑定整个 loop）
修复：
- 引用外移：在 loop 外先完成索引选择逻辑
- 用索引而非返回 &mut 元素引用
- 重构为不跨 loop 返回 borrow
深层：非线性控制流 + NLL 仍保守；未来 Polonius 借用检查器更精确
要点：loop 内返回引用 = 高危模式

闭包碰到特征对象-01

现象：闭包存入 Box<dyn Fn()> / 线程，move || ... 捕获局部引用报错
根因：
- trait object 常要求 'static
- 闭包捕获 &T → 闭包 lifetime 绑定到 T，非 'static
四种情况：
- 无捕获 → OK
- 捕获值（move）→ OK
- 捕获 &local → 非 'static，失败
- 要捕获引用 → 让数据活得够久（'static、Arc、泄漏）或改 API 带 lifetime
修复：move 所有权进闭包；或 Box<dyn Fn() + 'a> 显式生命周期；或不用 trait object
要点：'static 闭包 ≠ 静态变量；= 不含非 'static 引用捕获

重复借用

同时在函数内外使用引用

正确：同一函数内 let a = &mut self.a; let b = &mut self.b; — 编译器分字段借用
错误：let b = &mut self.b; self.increase_a(); — increase_a(&mut self) 视为整 struct mut borrow
根因：跨函数时编译器无法证明只碰一个字段（非词法、保守）
修复：
- 内联字段操作，不通过 &mut self 方法
- 用 RefCell/Cell 内部可变（运行时检查）
- 提取字段到局部变量再操作
CPU 模拟例子：多寄存器模拟分字段 vs 整 struct 借用

智能指针引起的重复借用错误

现象：RefCell 包 struct，分字段 borrow_mut 仍冲突
根因：RefCell::borrow_mut 锁的是整个 RefCell，非单字段
修复：每个需独立借用的字段单独 RefCell；或展开代码避免嵌套 borrow
延伸：Mutex、RwLock 等同理 — 锁粒度是容器级
练习：多 RefCell 字段的正确拆分模式

类型未限制(todo)

现象：泛型方法中 T 未 impl 所需 trait，报错模糊或延迟到调用处
要点：为 type parameter 加 where T: Trait；必要时 trait bound 写在 impl 块
状态：原书 todo，遇此类错误先查缺失 trait bound

幽灵数据(todo)

现象：结构体含 PhantomData 或裸指针，Send/Sync/variance 与直觉不符
要点：PhantomData<T> 标记逻辑持有关系；*const T 默认 !Send
状态：原书 todo；链表/unsafe 章节有 PhantomData 详例

Rust 常见陷阱

for 循环中使用外部数组

现象：for i in 0..v.len() { v.push(...); } — 死循环或 panic
根因：v.len() 每轮变；索引与长度不同步
修复：for item in v.iter()、while i < v.len() 谨慎设计、或倒序/remove

线程类型导致的栈溢出

现象：默认线程栈 2MB（平台相关），递归或大数组 on stack → stack overflow
根因：std::thread 栈固定；深层递归 / [[u8; N]] on stack
修复：放堆（Box/Vec）、减递归、thread::Builder::new().stack_size(...)

算术溢出导致的 panic

现象：Debug 默认 overflow panic；Release 可能 wrapping
根因：+ - * checked 行为随 profile 变
修复：checked_add / saturating_* / wrapping_*；Release 仍注意 overflow-checks

闭包中奇怪的生命周期

简单代码：闭包捕获引用，返回闭包，生命周期绑定输入
复杂代码：HRTB、Fn vs FnMut、闭包返回闭包时 lifetime _elision 失效
修复：显式标注 where for<'a> ... 或 'a on trait object；减少多层嵌套闭包

可变变量不可变？

现象：let mut x = ...; let y = &x; x = ... — 有 immut borrow 时不能 mut reassign
根因：mut 变量 ≠ 永远可变；存在活跃引用时禁止赋值（NLL）
修复：缩小 y 作用域；先用完借用再赋值

可变借用失败引发的深入思考

场景：重构后同一 scope 内 &mut self 方法 + 字段 mut ref 冲突（与「重复借用」同源）
闭包例子：闭包捕获 &mut self 同时调用 self.foo()
修复：分字段借用、内联、RefCell、重构 API 避免同时 &mut self 与字段 borrow
要点：编译器「冤枉」你时，往往是无法跨函数证明 disjoint fields

不太勤快的迭代器

现象：accounts.into_iter().map(|a| { map.insert... }); 输出 {}
根因：迭代器适配器懒惰，map 不执行，无 consumer
修复：.collect()、for 消费、for_each、.count() 等 consumer
对比：for 循环会立刻执行

奇怪的序列 x..y

现象：0..0 空、(0..5).len() 误用、.. 范围类型混淆
要点：a..b 半开区间；..=b 含 b；数组索引注意 off-by-one

无处不在的迭代器

现象：需要 Vec 却链式 adapter 类型对不上；或多次 consume iterator
根因：adapter 返回新 Iterator；move 后不能再用
修复：.collect::<Vec<_>>()；需多次遍历则 .clone() on iter（有代价）或 collect 后 reuse
最 Rusty：明确 consumer 终点

线程间传递消息导致主线程无法结束

现象：mpsc channel 未 drop sender，主线程 recv 永久阻塞
根因：Channel 存活则 receiver 等待
修复：drop 多余 Sender；用 drop(tx) 显式；或 scoped thread / oneshot

警惕 UTF-8 引发的性能隐患

现象：对 String 逐 chars() 与逐字节处理性能差 orders
根因：UTF-8 变长；.chars() 解码有开销；ASCII 路径应用 bytes
修复：确认纯 ASCII 用 as_bytes() / bytes()；国际化才 chars()

排错速查

错误关键词	优先怀疑
`borrowed as mutable ... immutable`	生命周期过大 / loop 返回 ref / 重复借用
`cannot borrow *self as mutable more than once`	分字段借用被函数调用打破
`does not live long enough`	引用指向局部；闭包/trait object lifetime
`expected closure ... Fn()`	捕获引用非 `'static`
iterator 无效果	缺 consumer
stack overflow	递归/大栈数组
channel block	sender 未 drop

源码路径：shengJing/_src/src/compiler/fight-with-compiler/ 与 pitfalls/。

18-Rust性能优化todo

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Rust 性能优化」

Rust 性能优化

本章仅提炼源码中已有正文（非 TODO 占位）。完整专题见 shengJing/_src/src/profiling/。

Copy 与 move 基础

实现 Copy 的类型赋值时复制值；未实现 Copy 的类型则转移所有权：

19-Rust区块链入门

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Rust 区块链入门」

Rust 区块链入门

占位说明：SUMMARY.md 中已列本章目录，但 _src/src/ 下尚无对应正文源文件。

Rust 在区块链领域采用率极高（Solana、Polkadot、Near 等），待源稿就绪后将在此补充：

20-Rust游戏开发入门

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Rust 游戏开发入门」

Rust 游戏开发入门

占位说明：SUMMARY.md 中已列本章目录，但 _src/src/ 下尚无对应正文源文件。

Rust 游戏生态含 Bevy、macroquad、Amethyst（归档）等，待源稿就绪后将在此补充：

21-Rust前端开发入门

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Rust 前端开发入门」

Rust 前端开发入门

占位说明：SUMMARY.md 中已列本章目录，但 _src/src/ 下尚无对应正文源文件。

Rust 在前端/WASM 方向有 wasm-bindgen、Leptos、Yew、swc 等，待源稿就绪后将在此补充：

22-Appendix

Tue, 28 Jul 2026 14:49:00 +0800

精要笔记 · 基于 Rust语言圣经「Appendix」

附录

A. 关键字

关键字不可作普通标识符（可用 r# 原生标识符绕过，如 r#match）。

当前使用中的关键字（按用途分类）

分类	关键字
声明	`let`, `const`, `static`, `fn`, `struct`, `enum`, `trait`, `impl`, `type`, `mod`, `use`, `pub`, `extern`, `crate`, `unsafe`
控制流	`if`, `else`, `match`, `loop`, `while`, `for`, `break`, `continue`, `return`
类型/泛型	`where`, `dyn`, `Self`, `self`, `super`, `as`, `in`, `ref`, `mut`, `move`
字面量	`true`, `false`

保留关键字（暂无功能）

abstract, async, await, become, box, do, final, macro, override, priv, try, typeof, unsized, virtual, yield