【 Rust探索】结构体的定义与实例化（学生信息结构体）

最新推荐文章于 2025-12-22 15:51:17 发布

原创最新推荐文章于 2025-12-22 15:51:17 发布 · 628 阅读

22 ·

CC 4.0 BY-SA版权

文章标签：

#rust #服务器 #开发语言

Rust探索专栏收录该内容

23 篇文章

订阅专栏

本案例将带你深入理解 Rust 中结构体（struct）的基本概念，掌握如何定义和实例化自定义数据类型。我们将以“学生信息管理”为实际场景，构建一个包含姓名、年龄、学号和成绩的 Student 结构体，并通过完整代码演示其创建、访问与方法调用过程。通过本案例的学习，你将建立起对 Rust 自定义复合类型的核心认知，为后续面向对象风格编程打下坚实基础。

一、什么是结构体？

在 Rust 中，结构体（struct） 是一种用户自定义的数据类型，用于将多个相关的值组合成一个有意义的整体。它类似于其他语言中的“类”或“记录”，但不包含继承机制，而是强调数据的安全封装与所有权管理。

Rust 提供了三种主要的结构体形式：

普通结构体（命名字段结构体）
元组结构体（无字段名的结构体）
单元结构体（无字段，用于标记用途）

本案例重点讲解最常用的——命名字段结构体。

二、结构体语法详解

基本语法结构

struct 结构体名称 {
    字段1: 类型,
    字段2: 类型,
    ...
}

例如，我们要表示一名学生的个人信息：

struct Student {
    name: String,      // 姓名
    age: u8,           // 年龄（0-255足够）
    student_id: String, // 学号
    grade: f32,        // 成绩（浮点数）
}

这个 Student 结构体包含了四个字段，分别使用不同的基本类型来存储数据。

三、完整代码演示：学生信息管理系统雏形

下面是一个完整的 Rust 程序，展示如何定义结构体、创建实例、打印信息并实现简单方法。

// 导入标准库中用于格式化输出的 trait
use std::fmt;

// 定义 Student 结构体
#[derive(Debug)]
struct Student {
    name: String,
    age: u8,
    student_id: String,
    grade: f32,
}

// 为 Student 实现 Display trait，支持自定义打印
impl fmt::Display for Student {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            f,
            "学生信息:\n  姓名: {}\n  年龄: {}\n  学号: {}\n  成绩: {:.2}/100",
            self.name, self.age, self.student_id, self.grade
        )
    }
}

// 为 Student 实现一些有用的方法
impl Student {
    // 关联函数：构造器（constructor），用于创建新实例
    fn new(name: &str, age: u8, student_id: &str, grade: f32) -> Self {
        Self {
            name: name.to_string(),
            age,
            student_id: student_id.to_string(),
            grade,
        }
    }

    // 方法：判断是否及格
    fn is_passing(&self) -> bool {
        self.grade >= 60.0
    }

    // 方法：升级年龄（可变借用）
    fn grow_one_year(&mut self) {
        self.age += 1;
        println!("{} 年龄已增加到 {} 岁", self.name, self.age);
    }

    // 方法：设置成绩
    fn set_grade(&mut self, new_grade: f32) {
        if (0.0..=100.0).contains(&new_grade) {
            self.grade = new_grade;
            println!("{} 的成绩已更新为 {:.2}", self.name, self.grade);
        } else {
            eprintln!("错误：成绩必须在 0.0 到 100.0 之间！");
        }
    }
}

fn main() {
    // 方式1：使用结构体字面量创建实例
    let mut alice = Student {
        name: "Alice".to_string(),
        age: 20,
        student_id: "S001".to_string(),
        grade: 88.5,
    };

    // 打印信息（利用 Debug 和 Display trait）
    println!("{:?}", alice); // Debug 输出
    println!("{}", alice);   // Display 输出

    // 调用方法
    println!("是否及格？{}", if alice.is_passing() { "是" } else { "否" });

    // 修改属性
    alice.grow_one_year();
    alice.set_grade(92.0);
    println!("{}", alice);

    // 方式2：使用构造函数创建另一个学生
    let bob = Student::new("Bob", 19, "S002", 55.0);
    println!("{}", bob);
    println!("Bob 是否及格？{}", if bob.is_passing() { "是" } else { "否" });
}

四、运行结果说明

执行上述程序后，输出如下：

Student { name: "Alice", age: 20, student_id: "S001", grade: 88.5 }
学生信息:
  姓名: Alice
  年龄: 20
  学号: S001
  成绩: 88.50/100
是否及格？是
Alice 年龄已增加到 21 岁
Alice 的成绩已更新为 92.00
学生信息:
  姓名: Alice
  年龄: 21
  学号: S001
  成绩: 92.00/100
学生信息:
  姓名: Bob
  年龄: 19
  学号: S002
  成绩: 55.00/100
Bob 是否及格？否

从输出可以看出：

我们成功定义了一个 Student 类型；
创建了多个实例；
能够安全地访问和修改字段；
使用了 impl 块添加行为（方法）；
支持友好的文本输出。

五、关键知识点解析与关键字高亮

以下是本案例中涉及的关键语法元素及其作用说明：

关键字/语法	高亮显示	作用说明
`struct`	`struct`	定义一个新的结构体类型
`String`	`String`	拥有所有权的动态字符串类型，适合存储可变文本
`u8`, `f32`	`u8`, `f32`	无符号8位整数和32位浮点数，节省内存且满足需求
`#[derive(Debug)]`	`#[derive(Debug)]`	自动生成 `Debug` trait 实现，允许使用 `{:?}` 打印结构体
`impl`	`impl`	为结构体实现方法或关联函数
`Self`	`Self`	在 `impl` 块中代表当前类型，等价于 `Student`
`&self`	`&self`	不可变借用自身，用于读取数据的方法
`&mut self`	`&mut self`	可变借用自身，用于修改数据的方法
`new()`	`new()`	惯用的构造函数命名，返回新实例
`write!`	`write!`	格式化写入输出流，配合 `Display` trait 使用
`contains()`	`contains()`	判断范围是否包含某值，避免手动比较边界

✅ 最佳实践提示：

所有拥有所有权的字段建议使用 String 而非 &str，除非明确需要引用。
构造函数应命名为 new 并返回 Self 类型。
对于频繁打印调试的结构体，务必加上 #[derive(Debug)]。
使用 Display trait 提供更人性化的输出格式。

六、数据表格：Student 结构体字段设计对比

字段名	数据类型	是否可变	示例值	设计理由
`name`	`String`	否（整体不可变，可通过方法改）	`"Alice"`	使用堆上字符串确保所有权清晰
`age`	`u8`	是	`20`	年龄不会超过 255，节省空间
`student_id`	`String`	否	`"S001"`	学号可能含字母，需动态字符串
`grade`	`f32`	是	`88.5`	支持小数成绩，精度足够

📊 表格说明：合理选择数据类型不仅能提升性能，还能增强类型安全性。例如，若用 i32 存年龄，则可能出现负数；而 u8 天然限制了非法输入。

七、分阶段学习路径：从零掌握结构体

为了帮助你系统掌握结构体这一核心特性，我们提供以下五个进阶阶段的学习路径：

🔹 阶段一：基础定义与实例化（初学者）

✅ 目标：能独立定义结构体并创建实例
✅ 练习任务：
- 定义 Book 结构体（title, author, pages）
- 创建两本书的实例并打印字段
💡 提示：使用 {} 或 {:?} 输出时记得加 #[derive(Debug)]

🔹 阶段二：添加方法与行为（初级开发者）

✅ 目标：学会使用 impl 块添加方法
✅ 练习任务：
- 为 Book 添加 .summary() 方法，返回简要介绍
- 添加 .is_long() 方法，判断页数 > 300
💡 提示：区分 &self 和 &mut self 的使用场景

🔹 阶段三：构造函数与默认值（中级）

✅ 目标：掌握工厂模式与默认初始化
✅ 练习任务：
- 实现 Book::new(title, author)，默认 pages: 0
- 实现 Book::default_fiction() 返回默认小说模板
💡 提示：可结合 Default trait 实现 .default()

🔹 阶段四：派生 Trait 与序列化（高级应用）

✅ 目标：让结构体支持更多标准功能
✅ 练习任务：
- 添加 #[derive(Clone, PartialEq, Serialize)]
- 使用 serde_json 将 Student 序列化为 JSON
💡 提示：引入外部依赖需在 Cargo.toml 添加 serde 和 serde_json

🔹 阶段五：嵌套结构体与模块化（项目级）

✅ 目标：构建复杂数据模型
✅ 练习任务：
- 定义 Classroom 包含多个 Student
- 将 Student 移入 models 模块
- 实现班级平均分计算方法
💡 提示：使用 Vec<Student> 存储学生列表，注意所有权转移

🚀 进阶建议：尝试将 Student 存入文件（JSON/CSV），实现持久化存储，迈向真实项目开发。

八、常见问题与陷阱规避

❌ 错误1：直接使用字符串字面量赋值给 `String` 字段

let s = Student {
    name: "Tom", // ❌ 错误！类型是 &str，不是 String
    ...
};

✅ 正确做法：

name: "Tom".to_string(),
// 或
name: String::from("Tom"),

❌ 错误2：忘记 `mut` 关键字导致无法修改字段

alice.grade = 95.0; // 如果 alice 不是 mut，编译失败

✅ 解决方案：声明变量时加上 mut

let mut alice = Student::new(...);

❌ 错误3：多个可变借用冲突

let mut s = Student::new("A", 20, "S1", 80.0);
let r1 = &mut s;
let r2 = &mut s; // ❌ 编译错误！同一时间只能有一个 &mut

✅ 正确做法：遵循借用规则，避免同时持有多个可变引用

❌ 错误4：未实现 `Display` 却试图美化输出

println!("{}", student); // 若未实现 Display，报错

✅ 解决方案：要么实现 fmt::Display，要么继续使用 {:?}

九、结构体与其他类型的对比

特性	结构体（struct）	元组（tuple）	枚举（enum）
是否有字段名	✅ 是	❌ 否	N/A
是否可添加方法	✅ 可用 `impl`	⚠️ 有限支持	✅ 可添加方法
是否支持模式匹配	❌ 不常用	✅ 可解构	✅ 主要用途之一
是否表达“多种状态”	❌ 单一结构	❌ 固定顺序	✅ 是（如 `Option<T>`）
内存布局	连续字段存储	连续元素存储	标签+数据联合