1.4 函数与包管理：分工与部门划分

1.4 函数与包管理：分工与部门划分

本节摘要：函数是 Go 组织逻辑的最小单元，包是最小复用单元。本节讲透多返回值、可变参数、命名返回值与 defer 收尾机制，再讲包的可见性规则与 module 依赖组织。掌握它们，你的代码才能既写对又拆得开——这也是第 5 章项目结构的直接铺垫。

语法会写了，本节回答组织问题：逻辑怎么封装成函数，函数怎么归拢成包。先从一个反问开始：为什么 Go 的函数几乎总是返回两个值？这个设计的答案，恰好串起本节一半的知识点。

为什么函数要多返回值

想想其他语言怎么处理"除法可能失败"：要么抛异常让调用方捕获，要么返回特殊值再让调用方判断。前者控制流隐没在异常栈里，后者没法同时带回"结果"和"原因"。Go 的答案是让函数直接返回两个值——结果和错误，并在语言层面把 if err != nil 钉成全民惯例。错误由此变成普通值，能存、能传、能包装，调用路径一目了然。

package main

import (
	"errors"
	"fmt"
)

// divide 返回商与错误，这是 Go 最典型的双返回值签名
func divide(a, b float64) (float64, error) {
	if b == 0 {
		return 0, errors.New("除数不能为零")
	}
	return a / b, nil
}

func main() {
	result, err := divide(10, 4)
	if err != nil {
		fmt.Println("失败:", err)
		return
	}
	fmt.Println("结果:", result)

	// 只关心其中一个值时，用下划线占位丢弃
	_, err = divide(1, 0)
	fmt.Println("第二次调用错误:", err)
}
// 运行输出:
// 结果: 2.5
// 第二次调用错误: 除数不能为零
​

函数参数同样有讲究：同类型参数可以连写（如上面的 a, b float64）；支持可变参数，形式上就是切片；函数本身是一等公民，可以赋给变量、当参数传递——第 4 章的中间件模式全靠这一特性。

defer：离岗前必做的收尾

defer 把一句调用登记到函数出口执行，无论函数从哪个 return 离开、甚至中途出错，登记过的收尾动作都会跑。它解决的是"资源释放与错误路径纠缠"的老问题：

package main

import "fmt"

func audit() {
	defer fmt.Println("第三步：写审计日志（后登记的先执行）")
	defer fmt.Println("第二步：关闭连接")
	defer fmt.Println("第一步：释放文件句柄")

	fmt.Println("业务执行中……")
	if true {
		return // 提前返回，defer 照样执行
	}
}
// 运行输出（注意顺序与登记顺序相反，defer 栈是后进先出）:
// 业务执行中……
// 第一步：释放文件句柄
// 第二步：关闭连接
// 第三步：写审计日志（后登记的先执行）
​

两条实战军规：defer 紧跟在资源获取成功之后写，间隔越短越不容易漏；循环体内慎用 defer，因为它要等整个函数结束才执行，长循环会积压大量收尾动作，必要时应抽成独立函数让 defer 随函数返回及时触发。

包：部门的墙与门

包是 Go 的编译与复用单位，同名标识符在不同包里互不冲突。可见性规则只有一条：标识符首字母大写即对外可见，小写仅包内可用。没有 public、private 关键字，大小写就是墙上的门。

包的初始化也有讲究：每个包可以有一个 init 函数，在 main 之前自动执行；被依赖的包先初始化，依赖方后初始化。这个顺序保证库在被使用前已完成自我准备，第 3 章会用它在程序启动时初始化调度器配置。

把函数归拢成包之后，跨包引用靠 import 路径，而路径的根就是 module。module 由项目根目录的 go.mod 文件声明，内容是模块名与 Go 版本，依赖的第三方模块也登记在这里：

$ go mod init shiftcenter
go: creating new go.mod: module shiftcenter
$ go mod tidy
go: finding module for package github.com/pkg/errors
go: added github.com/pkg/errors v0.9.1
​

go mod init 声明本模块身份；go mod tidy 扫描源码里的 import，自动补齐缺失依赖、清掉无用依赖。模块名通常用域名加路径的形式，避免与他人的包撞名——这是把"命名空间"外包给全球唯一域名的聪明做法。

完整案例：把排班计算拆成独立包

背景：主程序里排班逻辑越写越长，决定把"按工龄计算夜班补贴"拆成独立包，便于复用与单独测试。

操作：在项目下建 payroll 目录，声明包名；把计算函数移入，函数名首字母大写以对外开放；主包通过模块路径加目录名导入。

// payroll/payroll.go —— 包声明后，同目录所有文件共享该包名
package payroll

// NightPay 计算夜班补贴：基础时薪乘时长，深夜时段上浮两成
// 首字母大写，包外可调用；参数与返回值全部显式
func NightPay(hourly int, hours float64, deepNight bool) float64 {
	base := float64(hourly) * hours
	if deepNight {
		base *= 1.2
	}
	return base
}
​

// 主包调用方
package main

import (
	"fmt"

	"shiftcenter/payroll" // 模块路径加目录名
)

func main() {
	pay := payroll.NightPay(50, 8, true)
	fmt.Printf("夜班补贴: %.1f 元\n", pay)
}
// 运行输出:
// 夜班补贴: 480.0 元
​

结果：编译通过，主程序与薪酬包解耦，payroll 包可以单独跑测试。

解读：目录即包、路径即身份，Go 的物理结构与逻辑结构完全重合，看到 import 就知道文件在哪儿——不像某些语言要靠配置文件映射。小写函数（如内部的校验逻辑）留在包内当私有件，外部只见大写门面，封装不必依赖额外语法。

变式：如果 payroll 里出现只希望"本项目内"复用、不想开放给外部模块的逻辑，可以放进名为 internal 的子目录，Go 工具链会强制禁止项目外导入——这是语言内置的可见性边界，第 5 章项目结构会用到。

收班要点

• 多返回值加 error 惯例是 Go 错误处理的基石，错误是值，能传递能包装，控制流完全显式。
• defer 后进先出，紧跟资源获取代码登记，提前返回与出错路径都能收尾；循环体慎用。
• 首字母大小写即可见性：大写出门、小写留守，没有额外访问修饰符。
• init 按依赖顺序自动执行，库在被使用前完成自备。
• module 声明身份，go mod tidy 维护依赖，目录即包、路径即身份，物理与逻辑结构重合。

函数与包都能驾驭了，还差最后一道防线：程序出错时怎么办。下一节讲错误处理与日志的完整规矩。