go官方唯一推荐将context.context作为函数第一个参数传入，因其是生态标准、工具链识别前提、避免漏传和goroutine泄漏；不可用结构体字段或channel模拟，withvalue仅限不可变元数据，启动goroutine必须显式传ctx。
直接用 context.Context 类型作为函数第一个参数传进去，别绕弯、别存全局、别用 channel 模拟 —— 这是 Go 官方唯一推荐的方式。
为什么必须把 ctx 放在函数第一个参数
Go 生态（包括 net/http、database/sql、gRPC 等）约定俗成地把 context.Context 当作“控制权入口”。不放第一个位置，别人调你函数时容易漏传，工具链（比如 linter 或 trace 工具）也识别不了上下文传播链。
常见错误现象：
- 函数签名写成
func DoWork(data string, ctx context.Context)→ 调用方可能下意识忽略第二个参数 - 用结构体字段存
ctx→ 无法保证子 goroutine 继承的是同一棵 context tree - 用
goroutine启动时不显式传ctx→ 子 goroutine 拿到的是context.Background()，取消信号根本收不到
context.WithValue 不是用来传业务参数的
它只适合传请求范围的、不可变的元数据，比如 "request-id"、"user-id"、"trace-id"。不是用来替代函数参数或配置项的。
使用场景限制：
- key 必须是 unexported 类型（避免冲突），推荐用私有 struct 或
type userIDKey struct{} - value 最好是基本类型或不可变结构体；别传指针或 map，否则多个 goroutine 并发读写会出 data race
- 不要嵌套多层
WithValue传同一类信息 —— 查找开销是 O(n)，且容易掩盖真正的控制流
示例正确写法：
type userIDKey struct{}
ctx = context.WithValue(parentCtx, userIDKey{}, 123)
// 后续用：uid := ctx.Value(userIDKey{}).(int)
启动新 goroutine 时必须显式传 ctx，不能依赖闭包捕获
闭包捕获的 ctx 可能是父 goroutine 的旧副本，尤其在循环中启动多个 goroutine 时极易出错。
错误写法：
for _, id := range ids {
go func() { // ❌ 闭包捕获的是同一个变量 id 和 ctx
doSomething(ctx, id) // ctx 可能已被 cancel，id 可能是最后一个值
}()
}
正确写法：
for _, id := range ids {
id := id // 创建副本
go func(ctx context.Context, id int) { // ✅ 显式传入
doSomething(ctx, id)
}(ctx, id)
}
性能影响：每次 WithCancel / WithTimeout 都会创建新 context 实例，但开销极小（几个指针 + 一个 channel）。比起漏传导致 goroutine 泄漏，这点内存和分配完全值得。
cancel 函数必须调用，且只能调用一次
context.WithCancel、context.WithTimeout、context.WithDeadline 返回的 cancel 函数不是可选的 —— 它负责关闭 Done() channel 并清理内部引用。不调用会导致 goroutine 泄漏、内存泄漏、timer 不释放。
容易踩的坑：
- 在 defer 中调用
cancel()，但函数提前 return 了 → defer 不执行 - 多个 goroutine 共享同一个
cancel并并发调用 → panic: "send on closed channel" - 把
cancel传给子 goroutine 让它自己调 → 子 goroutine 崩溃时父级无法感知，资源没释放
建议做法：在生成 context 的作用域内管理 cancel，例如 HTTP handler 函数里 defer cancel()，或者用 errgroup.Group 统一等待并 cancel。
最常被忽略的一点：context 树一旦断开（比如某层忘了传 ctx），下游所有 goroutine 就彻底脱离控制 —— 它们既收不到取消信号，也不会因超时退出，只能靠进程重启硬杀。这种问题在线上往往表现为 CPU/内存缓慢爬升，排查起来非常隐蔽。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
