1 / 4概念
Syntax
Rust 的语法围绕“表达式求值 + 模式解构”展开:块有值,match 必须穷尽,? 在错误处提前返回,生命周期把借用的有效范围写进签名。判断标准不是“能不能编译”,而是读代码时能否直接看出控制流、所有权转移与失败路径。
1 概念
1.1 一句话定义
Rust 源码由条目声明(fn、struct、enum、trait、impl、mod、use)与表达式组成;let、match、if let、for 用模式解构值,泛型与 where 约束类型,macro_rules! 与过程宏在编译期生成代码。
1.2 它解决什么问题
- 枚举分支容易漏写:
match的穷尽性检查强制覆盖所有变体。 - 错误传播样板多:
?把“匹配 + 转换 + 返回”压成一个符号。 - 借用期限说不清:生命周期标注把引用有效期写进函数签名。
- 泛型约束散落在参数里:
where子句集中表达。 - 重复代码难维护:声明宏与过程宏在编译期展开。
- 语法无法一次改完:edition 让不兼容变更按 crate 渐进落地。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 所有权、借用与生命周期的语义 | Type |
| trait 设计、泛型、错误建模与异步 | OOP、Error、Async |
过程宏工程化(syn/quote、发布) | AOP |
| Cargo、clippy、fmt 与工具链配置 | 工具链章节 |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 表达式与语句 | 产生值的语法结构;带分号的表达式成为语句 | 带分号即丢弃块值 |
| 模式 | 解构值的形状描述 | 不是表达式 |
| 不可反驳模式 | 一定匹配,如 let (a, b) | 函数参数只能用这类 |
| 可反驳模式 | 可能不匹配,如 Some(x) | 需 match/if let 兜底 |
| guard | match 分支的 if 条件 | 不参与穷尽性判断 |
| 生命周期标注 | 'a 形式的借用命名,编译器可省略 | 不是运行时对象 |
| 泛型参数 | <T> 与 const 泛型 | 单态化后各生成一份 |
where 子句 | 集中书写约束 | 与内联约束等价 |
| 声明宏 | macro_rules! 按 token 匹配 | 不是函数调用 |
| 过程宏 | derive/属性/函数式三类 | 输入输出都是 token |
| edition | 语法与语义的版本开关 | 不是编译器版本 |
| 原始标识符 | r#type 把关键字当名字 | 不改变语义 |
2 机制
2.1 心智模型
把一段 Rust 代码看成“一个表达式树 + 一组模式”:每个块的值是最后一个不带分号的表达式,if、match、loop 都能直接产生值;模式负责把值拆成绑定,match 负责在拆解的同时强制穷尽;? 只是 match 加 From::from 加 return 的语法糖。
2.2 机制拆解
- 表达式与语句:块的值是尾部表达式;加分号变成语句并丢弃值;
if/match各分支类型必须一致。 - 不可反驳与可反驳:
let、函数参数、for只用不可反驳模式;match、if let、while let接受可反驳模式。 match的构成:分支 = 模式 + 可选 guard +=>表达式;|合并模式,@绑定子值,..=表示闭区间。- 穷尽性:编译器枚举所有变体;
_是兜底,但会吞掉未来新增的变体。 - 生命周期:
'a是借用范围的命名;省略规则三条(每输入引用独立、单输入输出继承、&self输出继承self)。 - 泛型与
where:<T: Trait>与where T: Trait等价;impl Trait用于参数与返回值;::<>(turbofish)在表达式中指定类型参数。 - 宏:
macro_rules!按 token 树匹配并展开;过程宏在编译期接收TokenStream,derive 只能附加、属性宏可替换条目。 - edition:在
Cargo.toml里声明;2015、2018、2021、2024 由同一编译器支持,可混合链接。
2.3 完整枚举
Rust 关键字全集,按用途分组(严格关键字 38 个,另有弱关键字与保留字):
| 类别 | 关键字 | 说明 |
|---|---|---|
| 条目与类型 | fn struct enum trait impl type const static extern mod use pub where | 声明可调用项、类型、模块、可见性与泛型约束 |
| 路径与导入 | crate super self Self as | 路径前缀、当前项、强制转换与重命名 |
| 变量与所有权 | let mut ref move dyn | 绑定、可变性、模式引用、闭包捕获、trait 对象 |
| 控制流与布尔 | if else match loop while for in break continue return true false | 分支、循环与布尔字面量 |
| 异步与安全 | async await unsafe | 异步函数/块、等待点、未检查边界 |
| 弱关键字 | macro_rules union raw 'static | 仅在特定位置有特殊含义 |
| 保留(2015) | abstract become box do final macro override priv typeof unsized virtual yield | 不可作标识符 |
| 保留(2018/2024) | try gen | 2018 保留 try,2024 保留 gen;可用 r#try 转义 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 严格关键字 | 38 个 | 2018 edition 的稳定集合 |
| 保留字 | 14 个 | 12 个历史保留 + try + gen |
| edition 数量 | 4 个 | 2015、2018、2021、2024 |
| 生命周期省略规则 | 3 条 | 输入独立、单输入继承、&self 继承 |
| 过程宏种类 | 3 类 | derive、属性、函数式 |
| 标准可 derive trait | 9 个 | Clone Copy Debug Default Eq Hash Ord PartialEq PartialOrd |
? 稳定版本 | 1.13(2016-11) | 需要函数返回 Result/Option |
async/await 稳定 | 1.39(2019-11) | 2018 edition 起可用 |
| 2024 edition 稳定 | 1.85(2025-02) | cargo new 的默认 edition |
3 实践
3.1 最小示例
一段代码覆盖枚举解构、match 穷尽、泛型与 where、生命周期、if let 与 ?:
enum Shape {
Circle(f64),
Rect { w: f64, h: f64 },
Point,
}
fn area(shape: &Shape) -> f64 {
match shape {
Shape::Circle(r) => std::f64::consts::PI * r * r,
Shape::Rect { w, h } => w * h,
Shape::Point => 0.0,
}
}
fn max_area<'a, T, F>(items: &'a [T], measure: F) -> Option<&'a T>
where
F: Fn(&T) -> f64,
{
items.iter().max_by(|a, b| measure(a).total_cmp(&measure(b)))
}
fn parse_area(raw: &str) -> Result<f64, std::num::ParseFloatError> {
let value: f64 = raw.trim().parse()?;
Ok(value * 2.0)
}
fn main() {
let shapes = [Shape::Circle(1.0), Shape::Rect { w: 2.0, h: 3.0 }, Shape::Point];
if let Some(biggest) = max_area(&shapes, area) {
println!("largest area = {}", area(biggest));
}
match parse_area(" 21 ") {
Ok(value) => println!("parsed = {value}"),
Err(error) => eprintln!("parse failed: {error}"),
}
}
读法:Shape 的三个变体让 match 必须写满三支,删掉任何一支都会得到 E0004。max_area 的生命周期 'a 把返回值绑定到输入切片,where F: Fn(&T) -> f64 允许传入函数项或闭包。parse_area 里 ? 在 Err 时把 ParseFloatError 原样返回,等价于一个 match 加 return。if let 是可反驳模式的单分支用法,不需要写 _ => ()。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 元组解构 | let (a, b) = pair; | 不可反驳模式 |
| 结构体解构 | let Point { x, y } = p; | 可用 .. 忽略其余字段 |
| 枚举分支 | match v { A(x) => x, B { y } => y } | 必须穷尽 |
| 守卫 | n if n > 0 => ... | 不参与穷尽性判断 |
| 范围模式 | 1..=9 => ... | 只支持可比较的整型与字符 |
| 绑定子值 | Some(n @ 1..=9) => ... | @ 同时匹配并命名 |
| 单分支 | if let Some(v) = opt { ... } | 不需要兜底分支 |
| 提前返回 | let Some(v) = opt else { return }; | else 必须发散 |
| 指定类型参数 | parse::<u16>() | 表达式中用 turbofish |
3.3 标准流程
- 先用
enum把所有状态与失败变体列全,再写match穷尽。 - 单变体分支用
if let,提前退出用let ... else,循环解构用while let。 - 生命周期先省略;编译器报 E0106 时再补最小标注,不要给每个引用加
'a。 - 泛型约束先内联,超过两个或带关联类型时改用
where。 - 错误传播统一用
?;需要补上下文时先map_err再?。 - 宏只用来消除重复的声明样板;提交前用
cargo expand检查展开并跑clippy。
3.4 与相邻技术的组合
- serde:
#[derive(Serialize, Deserialize)]与#[serde(rename_all = "kebab-case")]把结构体映射成协议字段。 - clap:derive 宏从结构体字段生成命令行参数,
#[arg(short, long)]控制短选项。 - tracing:
#[instrument(skip(self))]为函数自动创建 span。 - 条件编译:
#[cfg(target_os = "linux")]与#[cfg(feature = "tls")]在编译期裁剪代码。
3.5 选型维度
| 场景 | 选择 | 理由 |
|---|---|---|
| 多分支枚举 | match | 穷尽性检查 |
| 单分支解构 | if let | 不写无意义的兜底 |
| 消费迭代器 | for + 模式 | 借用语义清晰 |
| 可能失败的解析 | ? | 自动 From 转换 |
| 复杂泛型约束 | where 子句 | 签名更易读 |
| 多处重复实现 | 声明宏 | 编译期展开、无运行时成本 |
| 需要读取语法结构 | 过程宏 | 可分析 token 树 |
3.6 决策规则
- 能用类型与
match表达的状态,不要用布尔标志和if链。 - 分支里只做值计算;副作用放到分支外或独立函数,便于测试。
_ =>只用于真正不关心的值;公共枚举优先写全,让新增变体在编译期暴露。- 宏的展开结果要能读懂;
cargo expand看过再提交。 - edition 升级按 crate 逐步做,升级后跑完整测试与
clippy。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
match + enum | 穷尽性、可读、可优化 | 变体多时分支长 | 状态机、协议解析 |
if/else 链 | 写法直白 | 易漏分支、难优化 | 两三个条件 |
| trait 对象多态 | 新增类型不改调用方 | 运行时间接调用 | 插件式扩展 |
| 声明宏 | 消除声明样板 | 报错指向展开点 | 重复 impl、测试表 |
| 过程宏 | 可解析结构、生成 API | 编译慢、调试难 | derive、DSL |
3.8 何时不该用
- 分支只有两三个且无新增变体预期时,
match反而增加噪音。 - 宏会显著拖慢编译或让错误信息失真时,改用泛型或手写。
- 生命周期标注开始主导签名时,说明 API 该返回拥有所有权的值。
- edition 尚未被依赖生态普及时,不要为新语法牺牲可构建性。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| E0004 非穷尽匹配 | 漏了枚举变体 | 补分支或用 _ 兜底 |
| E0382 使用已移动的值 | 值被移动后再次使用 | 改借用、克隆或调整顺序 |
| E0106 缺少生命周期标注 | 返回值有多个借用来源 | 标注输出与哪个输入同生命周期 |
E0277 ? 类型不匹配 | 函数返回 () 或错误类型无 From | 改返回类型或 map_err |
let ... else 报错 | else 分支未发散 | 用 return/panic!/continue |
E0796 引用 static mut | 2024 edition 收紧 | 改用 &raw/Mutex/OnceLock |
gen 不能作标识符 | 2024 保留字 | 用 r#gen 或改名 |
| 宏报 no rules expected | token 形状与规则不匹配 | cargo expand 看输入 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
用 _ => 吞掉所有剩余分支 | 新增变体不再报错 | 写全变体,必要时 #[non_exhaustive] |
给每个引用都标 'a | 签名噪音、API 难用 | 先省略,按报错补 |
| 用宏替代泛型 | 报错难读、IDE 支持差 | 泛型 + trait |
在 match 分支里写副作用 | 逻辑分散、难测试 | 分支只算值 |
4.3 可观测信号
编译器是最直接的信号:E0004 暴露漏分支,E0106 暴露生命周期设计问题,E0277 暴露 ? 与返回类型不匹配。clippy 的 match_same_arms、single_match、needless_lifetimes、redundant_closure 指出可简化写法。cargo expand 检查宏展开,cargo fix --edition 报告迁移点,cargo semver-checks 检查公开语法变化是否破坏兼容。
4.4 安全 / 性能 / 一致性边界
- 安全:
unsafe块不改变语法检查范围;宏卫生只隔离名字,不校验类型契约。 - 性能:
match通常编译成跳转表或有理分支,成本可忽略;泛型单态化放大代码体积;宏无运行时成本但会拖慢编译。 - 一致性:edition 是 crate 级开关,混用 edition 的依赖仍可链接,但迁移必须逐 crate 验证。
- 可读性:生命周期标注与宏展开是主要可读性风险;API 文档应给出展开后的等价写法。