01-结构体

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/custom_types/structs.html

结构体

结构体（structure，缩写成 struct）有 3 种类型，使用 struct 关键字来创建：

元组结构体（tuple struct），事实上就是具名元组而已。
经典的 C 语言风格结构体（C struct）。
单元结构体（unit struct），不带字段，在泛型中很有用。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71


#[derive(Debug)]
struct Person {
 name: String,
 age: u8,
}

// 单元结构体
struct Unit;

// 元组结构体
struct Pair(i32, f32);

// 带有两个字段的结构体
struct Point {
 x: f32,
 y: f32,
}

// 结构体可以作为另一个结构体的字段
#[allow(dead_code)]
struct Rectangle {
 // 可以在空间中给定左上角和右下角在空间中的位置来指定矩形。
 top_left: Point,
 bottom_right: Point,
}

fn main() {
 // 使用简单的写法初始化字段，并创建结构体
 let name = String::from("Peter");
 let age = 27;
 let peter = Person { name, age };

 // 以 Debug 方式打印结构体
 println!("{:?}", peter); // Person { name: "Peter", age: 27 }

 // 实例化结构体 `Point`
 let point: Point = Point { x: 10.3, y: 0.4 };

 // 访问 point 的字段
 println!("point coordinates: ({}, {})", point.x, point.y); // point coordinates: (10.3, 0.4)

 // 使用结构体更新语法创建新的 point，
 // 这样可以用到之前的 point 的字段
 let bottom_right = Point { x: 5.2, ..point };

 // `bottom_right.y` 与 `point.y` 一样，因为这个字段就是从 `point` 中来的
 println!("second point: ({}, {})", bottom_right.x, bottom_right.y); // second point: (5.2, 0.4)

 // 使用 `let` 绑定来解构 point
 let Point { x: left_edge, y: top_edge } = point;

 let _rectangle = Rectangle {
 // 结构体的实例化也是一个表达式
 top_left: Point { x: left_edge, y: top_edge },
 bottom_right: bottom_right,
 };

 // 实例化一个单元结构体
 let _unit = Unit;

 // 实例化一个元组结构体
 let pair = Pair(1, 0.1);

 // 访问元组结构体的字段
 println!("pair contains {:?} and {:?}", pair.0, pair.1); // pair contains 1 and 0.1

 // 解构一个元组结构体
 let Pair(integer, decimal) = pair;

 println!("pair contains {:?} and {:?}", integer, decimal); // pair contains 1 and 0.1
}

动手试一试:

增加一个计算 Rectangle （长方形）面积的函数 rect_area（尝试使用嵌套的解构方式）。
增加一个函数 square，接受的参数是一个 Point 和一个 f32，并返回一个 Rectangle（长方形），其左上角位于该点上，长和宽都对应于 f32。

参见:

属性和解构

03-常量

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/custom_types/constants.html

常量

Rust 有两种常量，可以在任意作用域声明，包括全局作用域。它们都需要显式的类型声明：

const：不可改变的值（通常使用这种）。
static：具有 'static 生命周期的，可以是可变的变量（译注：须使用 static mut 关键字）。

有个特例就是 "string" 字面量。它可以不经改动就被赋给一个 static 变量，因为它的类型标记：&'static str 就包含了所要求的生命周期 'static。其他的引用类型都必须特地声明，使之拥有 'static 生命周期。这两种引用类型的差异似乎也无关紧要，因为无论如何，static 变量都得显式地声明。

第3章 自定义类型 on 编程那些事儿

01-结构体

结构体

动手试一试:

参见:

03-常量

常量

第3章自定义类型 on 编程那些事儿