rust:结构体

13. 结构体

  • 理解结构体(struct)的作用和三种形式。
  • 掌握结构体的定义、实例化和字段访问。
  • 理解结构体与所有权、借用、引用的关系。
  • 学会为结构体定义方法(method)和关联函数(associated function)。

当单个变量无法完整描述一个事物时,可以用结构体把相关数据组合在一起:

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);
}

结构体让代码更有语义,也能避免用不相关的元组硬拼数据。

最常见的形式:

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 或作为类型标记。

基于已有实例创建新实例时,可以使用结构体更新语法:

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 将不再能使用这些字段。

结构体拥有其字段的所有权(除非字段是引用)。如果字段是 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); // 仍然有效
}

如果结构体包含引用字段,则需要显式标注生命周期(本阶段不深入,后续进阶课程会讲)。

方法是在结构体(或枚举、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 不可变借用,只读访问,最常用
&mut self 可变借用,可以修改
self 获取所有权,会消耗实例

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。

如果希望结构体实例能直接被打印,可以使用 #[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 等。

结构体形式 示例 使用场景
———–—————
命名字段结构体 struct User { name: String } 复杂数据组合
元组结构体 struct Point(i32, i32) 简单、字段意义明确的组合
单元结构体 struct AlwaysEqual; 类型标记、trait 实现
  1. 下面的代码为什么会报错?如何修改?
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);
}
  1. 方法 &self 和 self 有什么区别?什么时候应该使用 self?
  2. 尝试写一个 Circle 结构体,包含半径,并实现计算面积和周长的方法。

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • rust/结构体.1786548754.txt.gz
  • 最后更改: 2026/08/12 23:32
  • 由 张叶安