13. 结构体
学习目标
- 理解结构体(struct)的作用和三种形式。
- 掌握结构体的定义、实例化和字段访问。
- 理解结构体与所有权、借用、引用的关系。
- 学会为结构体定义方法(method)和关联函数(associated function)。
13.1 为什么需要结构体
当单个变量无法完整描述一个事物时,可以用结构体把相关数据组合在一起:
- snippet.rust
struct User { username: String, email: String, sign_in_count: u64, active: bool, } fn main() { let user1 = User { email: String::from("someone@example.com"), username: String::from("someusername123"), active: true, sign_in_count: 1, }; println!("{}", user1.email); }
结构体让代码更有语义,也能避免用不相关的元组硬拼数据。
13.2 三种结构体
命名字段结构体
最常见的形式:
- snippet.rust
struct Rectangle { width: u32, height: u32, }
元组结构体
字段没有名字,只有类型:
- snippet.rust
struct Point(i32, i32); fn main() { let p = Point(10, 20); println!("x = {}, y = {}", p.0, p.1); }
元组结构体适合简单、字段含义明显的组合。
单元结构体
没有任何字段:
- snippet.rust
struct AlwaysEqual; fn main() { let _subject = AlwaysEqual; }
单元结构体常用于实现 trait 或作为类型标记。
13.3 结构体更新语法
基于已有实例创建新实例时,可以使用结构体更新语法:
- snippet.rust
fn main() { let user1 = User { email: String::from("old@example.com"), username: String::from("old"), active: true, sign_in_count: 1, }; let user2 = User { email: String::from("new@example.com"), ..user1 }; }
..user1 会把 user1 中剩余的字段值移动到 user2。如果某些字段没有实现 Copy,user1 将不再能使用这些字段。
13.4 结构体与所有权
结构体拥有其字段的所有权(除非字段是引用)。如果字段是 String 等堆类型,结构体实例移动时,字段也会移动:
- snippet.rust
struct User { username: String, email: String, } fn main() { let u = User { username: String::from("alice"), email: String::from("alice@example.com"), }; let name = u.username; // u.username 被移动到 name // println!("{}", u.username); // 错误 println!("{}", u.email); // 仍然有效 }
如果结构体包含引用字段,则需要显式标注生命周期(本阶段不深入,后续进阶课程会讲)。
13.5 方法语法
方法是在结构体(或枚举、trait 对象)上下文中定义的函数。第一个参数是 self:
- snippet.rust
struct Rectangle { width: u32, height: u32, } impl Rectangle { fn area(&self) -> u32 { self.width * self.height } fn can_hold(&self, other: &Rectangle) -> bool { self.width > other.width && self.height > other.height } } fn main() { let rect1 = Rectangle { width: 30, height: 50 }; println!("面积为 {}", rect1.area()); }
`self` 的三种形式
| 形式 | 说明 |
&self | 不可变借用,只读访问,最常用 |
&mut self | 可变借用,可以修改 |
self | 获取所有权,会消耗实例 |
13.6 关联函数
impl 块中不以 self 作为第一个参数的函数称为关联函数,通常用作构造器:
- snippet.rust
impl Rectangle { fn square(size: u32) -> Rectangle { Rectangle { width: size, height: size } } } fn main() { let sq = Rectangle::square(10); }
关联函数通过 :: 调用,类似于 String::from。
13.7 派生 trait
如果希望结构体实例能直接被打印,可以使用 #[derive(Debug)]:
- snippet.rust
#[derive(Debug)] struct Rectangle { width: u32, height: u32, } fn main() { let rect = Rectangle { width: 30, height: 50 }; println!("rect = {:?}", rect); println!("rect = {:#?}", rect); // 格式化输出 }
Debug 是常用派生 trait 之一,其他还有 Clone、Copy、PartialEq 等。
13.8 小结
| 结构体形式 | 示例 | 使用场景 |
| 命名字段结构体 | struct User { name: String } | 复杂数据组合 |
| 元组结构体 | struct Point(i32, i32) | 简单、字段意义明确的组合 |
| 单元结构体 | struct AlwaysEqual; | 类型标记、trait 实现 |
13.9 思考题
- 下面的代码为什么会报错?如何修改?
- snippet.rust
struct Person { name: String, age: u32, } fn main() { let p = Person { name: String::from("Alice"), age: 30, }; let n = p.name; println!("{}", p.name); }
- 方法
&self和self有什么区别?什么时候应该使用self? - 尝试写一个
Circle结构体,包含半径,并实现计算面积和周长的方法。