Rust / 系统课时

定义结构体

定义结构体

结构体用于把多个相关字段组合成一个清晰的数据类型。本课将依次定义命名结构体、元组结构体和单元结构体,并通过完整示例演示实例创建、字段读取、更新语法与所有权边界。

学习目标

  • 能定义三种结构体并判断各自适用场景
  • 能创建实例、访问字段并使用结构体更新语法
  • 能识别字段移动导致的所有权限制

三种结构体的定义方式

命名结构体为每个字段提供名称,适合表达有明确业务含义的数据。字段之间使用逗号分隔,最后一个字段也建议保留逗号,便于后续修改。

元组结构体只有类型和位置,没有字段名,适合包装单个值或表示字段数量少、顺序固定的数据。单元结构体不保存字段,常用于实现 trait、标记类型或表示一种行为身份。

rust
#[derive(Debug)]
struct User {
    username: String,
    active: bool,
    sign_in_count: u64,
}

// 元组结构体通过位置区分三个颜色分量
#[derive(Debug)]
struct Color(u8, u8, u8);

// 单元结构体只表达类型身份,不保存状态
#[derive(Debug)]
struct AuditMarker;

fn main() {
    let user = User {
        username: String::from("alice"),
        active: true,
        sign_in_count: 1,
    };

    let black = Color(0, 0, 0);
    let marker = AuditMarker;

    println!("{user:?}");
    println!("RGB = ({}, {}, {})", black.0, black.1, black.2);
    println!("{marker:?}");
}

预期输出:

text
User { username: "alice", active: true, sign_in_count: 1 }
RGB = (0, 0, 0)
AuditMarker

#[derive(Debug)] 让结构体可以通过 {:?} 输出。命名结构体使用字段名访问数据,元组结构体则通过 .0、.1 等索引访问。

创建与更新实例

当变量名与字段名相同时,可以使用字段初始化简写。若需要基于旧实例创建新实例,可使用 ..旧实例 填充未显式指定的字段。

rust
#[derive(Debug)]
struct User {
    username: String,
    active: bool,
    sign_in_count: u64,
}

fn build_user(username: String) -> User {
    // 字段名与变量名一致时可省略重复书写
    User {
        username,
        active: true,
        sign_in_count: 1,
    }
}

fn main() {
    let user1 = build_user(String::from("alice"));

    // 其余字段从 user1 获取,显式字段优先
    let user2 = User {
        username: String::from("bob"),
        ..user1
    };

    println!("{user2:?}");
}

预期输出:

text
User { username: "bob", active: true, sign_in_count: 1 }

更新语法不是逐字段“深拷贝”。示例中 active 和 sign_in_count 实现了 Copy,因此可以复制;username 在 user2 中被重新赋值,没有从 user1 移动。

可变性、所有权与选型

Rust 不允许只把某个字段声明为可变。要修改字段,必须把整个实例声明为 mut。

rust
#[derive(Debug)]
struct User {
    username: String,
    active: bool,
}

fn main() {
    // 可变性属于整个实例,而不是某一个字段
    let mut user = User {
        username: String::from("alice"),
        active: true,
    };

    // 修改期间仍需满足 Rust 的借用规则
    user.active = false;
    println!("{}: {}", user.username, user.active);
}

预期输出:

text
alice: false

结构体拥有其字段。若字段类型是 String,实例离开作用域时会自动释放该字符串。若结构体保存引用,则必须增加生命周期标注;在只需快速建模时,优先让结构体直接拥有数据,可减少借用关系的复杂度。

命名结构体适合用户、订单、配置等字段含义明确的对象。元组结构体适合创建具有独立类型语义的轻量包装,例如 UserId(u64),它能避免把普通 u64 误传到其他位置。单元结构体不保存状态,适合标记、策略或仅需实现 trait 的类型。

易错点:使用 ..旧实例 后,若旧实例中的非 Copy 字段被移动,新实例创建完成后就不能再整体使用旧实例。

本课总结

  • 命名结构体依靠字段名表达含义,元组结构体依靠位置,单元结构体不保存数据
  • 实例可通过字段初始化简写和 ..旧实例 快速创建,但要注意非 Copy 字段的移动
  • 修改字段前必须把整个结构体实例声明为 mut

下一课预告

下一课将使用 impl 为结构体添加实例方法和关联函数,并比较 self、&self 与 &mut self 三种接收方式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义结构体

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通