2.1 结构体与方法：员工档案卡

2.1 结构体与方法：员工档案卡

本节摘要：结构体是 Go 组织数据的基本容器，方法是绑定在类型上的操作。本节覆盖结构体声明、字段零值、嵌入组合与方法定义，核心问题是值接收者与指针接收者如何选择。掌握本节，你就能为任意业务实体建立操作完备的"档案卡"。

第 1 章的语法只能表达单个值，本节开始把相关字段收拢成档案卡。调度中心的每名员工都有一张卡：姓名、工号、在岗时长——结构体干的就是这件事，而方法就是在档案卡上能做的操作（打卡、调岗、算工时）。本节是全章的地基，接口与泛型都要以结构体为常见载体。

给员工建档：结构体声明与使用

package main

import "fmt"

// Employee 员工档案卡：字段描述"是什么"
type Employee struct {
	Name   string
	ID     int
	Hours  float64  // 本月在岗时长
	Tags   []string // 技能标签，切片字段注意零值为 nil
}

func main() {
	// 字面量初始化：字段名写法最安全，新增字段不破坏调用方
	e := Employee{Name: "小陈", ID: 1024, Hours: 162.5, Tags: []string{"Go", "运维"}}

	// 零值建档：不赋任何字段，各字段取类型零值
	var intern Employee
	fmt.Printf("%s 工号 %d，在岗 %.1f 小时，标签 %v\n", e.Name, e.ID, e.Hours, e.Tags)
	fmt.Printf("实习档案: %+v\n", intern) // 加号动词打印字段名，排障利器
}
// 运行输出:
// 小陈 工号 1024，在岗 162.5 小时，标签 [Go 运维]
// 实习档案: {Name: ID:0 Hours:0 Tags:[]}
​

字段访问用点号， 无论通过值还是指针都写作 e.Name，指针的自动解引用由编译器处理。打印时 %+v 带字段名输出，是日志排障的高频技巧。还有一条语法糖值得知道：结构体可以匿名嵌入另一个结构体，被嵌入类型的字段与方法直接"提升"到外层，这是 Go 表达组合的主要方式，没有继承链，只有拼装。

图 2-1：结构体的内存布局

这张图解释了很多"灵异现象"：把结构体当参数传，字符串与切片字段复制的是头部，两个副本依然看到同一份堆数据。浅拷贝与深拷贝的边界，从这里开始建立直觉。

方法：绑在类型上的操作

方法就是带接收者的函数，接收者写在 func 与方法名之间。同一个 Employee，用两种接收者各写一个方法，行为差异立刻可见：

package main

import "fmt"

type Counter struct {
	N int
}

// 值接收者：拿到的是副本，改 N 不影响原值
func (c Counter) IncBroken() {
	c.N++
}

// 指针接收者：拿到原值的地址，改动真实生效
func (c *Counter) Inc() {
	c.N++
}

func main() {
	c := Counter{}
	c.IncBroken()
	fmt.Println("值接收者调用后:", c.N)
	c.Inc() // 语法糖，等价于 (&c).Inc()
	fmt.Println("指针接收者调用后:", c.N)
}
// 运行输出:
// 值接收者调用后: 0
// 指针接收者调用后: 1
​

值接收者意味着"只读操作"，调用方数据绝无副作用，但也意味着每次调用都完整复制结构体——大结构体频繁调用会有真实的复制开销。指针接收者意味着"可写操作"，代价是方法内部要考虑空指针的可能。

选择接收者的三条决策规则

• 方法需要修改接收者 → 指针接收者，没有商量余地。
• 结构体含切片、映射、锁等引用型字段 → 统一用指针接收者，避免"半个副本"的诡异状态——这一点在第 3 章并发场景里会升级成铁律。
• 小型纯值结构体（如坐标、金额）且方法只读 → 值接收者，换来不可变的安全感。

还有一条一致性要求：同一个类型的方法接收者种类要统一，混用会让"这个值到底是不是指针语义"变得难以推理。标准库的惯例是：一旦出现一个指针接收者，其余方法也全部改用指针接收者。

完整案例：月度工时统计

背景：调度中心要统计每名员工的月度工时，超时给补贴提示，不足发提醒。

操作：为 Employee 定义指针接收者的 AddHours 与 Stat 方法，主流程按月追加时长后输出统计。

package main

import "fmt"

type Employee struct {
	Name  string
	Hours float64
}

// AddHours 追加工时：修改状态，必须指针接收者
func (e *Employee) AddHours(h float64) { e.Hours += h }

// Stat 输出统计：只读，保持与 AddHours 相同的指针接收者以统一风格
func (e *Employee) Stat() {
	switch {
	case e.Hours > 160:
		fmt.Printf("%s 工时 %.1f，符合补贴条件\n", e.Name, e.Hours)
	case e.Hours < 80:
		fmt.Printf("%s 工时 %.1f，低于下限需约谈\n", e.Name, e.Hours)
	default:
		fmt.Printf("%s 工时 %.1f，正常\n", e.Name, e.Hours)
	}
}

func main() {
	team := []Employee{{Name: "小陈"}, {Name: "老周"}, {Name: "小吴"}}
	team[0].AddHours(170)
	team[1].AddHours(60)
	team[2].AddHours(120)
	for i := range team {
		team[i].Stat() // 注意 range 变量是副本，取下标才能改原值
	}
}
// 运行输出:
// 小陈 工时 170.0，符合补贴条件
// 老周 工时 60.0，低于下限需约谈
// 小吴 工时 120.0，正常
​

结果：三人各归其位，输出与工时一一对应。

解读：案例里有两处指针语义在起作用——AddHours 用指针修改原值；遍历用下标而不是 range 值变量，因为值变量是副本，对副本调用 AddHours 改不动原切片。Go 1.22 起循环变量语义已修复为每轮新变量，但"通过元素自身地址修改"的写法仍是最稳的习惯。

变式：给 Employee 加一个 Tags 切片字段后，用值接收者写一个 FilterTags 方法返回新切片。你会发现即使接收者是值的副本，Tags 指向的底层数组仍然共享——想在方法里安全修改切片内容，要么重新分配，要么指针接收者。这个坑 3.3 节讲 channel 传切片时还会再撞一次。

收班要点

• 结构体用字段名初始化最抗变更；%+v 打印带字段名，排障首选。
• 匿名嵌入实现组合，字段与方法自动提升，没有继承链。
• 值接收者拿副本、指针接收者拿原值，选择看是否需要修改与结构体大小。
• 接收者风格必须统一，出现一个指针就全用指针。
• 引用型字段（切片、映射）的副本仍共享底层数据，浅拷贝边界要时刻在线。

档案卡建好了，但调度中心不关心"你是谁"，只关心"你会什么"。下一节的接口，就是那张岗位说明书。