应直接传 context.Context 而非自定义结构体，因其是只读接口，保障不可变性与并发安全；需用 WithCancel/WithTimeout 等派生上下文并配对 defer cancel()，禁止传递 cancel 函数，且必须原样透传 ctx。
为什么直接传 context.Context 而不是自定义结构体
因为 context.Context 是只读接口，底层实现依赖不可变性和并发安全——你不能修改它，只能用 context.WithCancel、context.WithTimeout 等函数派生新上下文。如果自己封装结构体传取消信号，很容易漏掉 goroutine 泄漏或 cancel 调用时机错乱。
常见错误现象：defer cancel() 放在顶层函数里，但子函数已提前返回，导致 cancel 未被调用；或者多个 goroutine 共享同一个 cancel 函数，意外提前终止其他分支。
- 永远用
ctx, cancel := context.WithCancel(parentCtx)派生，且每个派生上下文配对一个defer cancel() - 不要把
cancel函数传给下游——下游不该决定何时取消，只响应ctx.Done() - 父级传入的
ctx必须原样传给所有子调用，不加包装也不过滤
多级调用中如何避免 ctx.Done() 被忽略
很多问题不是 Context 没传下去，而是中间某层函数没检查 ctx.Done() 或没把它传给下一层 I/O 操作。比如调用 http.Client.Do 时没把 ctx 注入到 http.Request，或数据库查询没传给 db.QueryContext。
使用场景：HTTP 请求 → 解析 JSON → 写入 DB → 发送消息，每一步都可能阻塞。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 所有支持 context 的标准库函数（如
http.NewRequestWithContext、json.NewDecoder(r).Decode配合io.ReadCloser超时控制）必须显式传ctx - 自定义函数签名统一以
func(ctx context.Context, ...)开头，强制调用方意识到可取消性 - 遇到不支持 context 的老代码（比如某些第三方 SDK），用
select手动监听ctx.Done()并主动退出
context.WithTimeout 和 context.WithDeadline 到底该选哪个
本质区别是时间基准不同：WithTimeout 是相对当前时间的偏移量，WithDeadline 是绝对时间点。多数情况下用 WithTimeout 更直观，但跨层级传递时容易累积误差。
性能影响：两者底层都是基于 timer，无显著差异；但 WithDeadline 在服务间传递时更可靠——比如上游设了 5s 超时，中间层做日志耗时 100ms，若用 WithTimeout(ctx, 4900*time.Millisecond)，下游拿到的就是“剩余 4.9s”，而 WithDeadline 可保证所有层级看到同一截止时刻。
- 单次本地调用（如 DB 查询）用
context.WithTimeout(ctx, 2*time.Second) - 服务链路（RPC、HTTP 转发）优先用
context.WithDeadline(ctx, time.Now().Add(5*time.Second)) - 永远别在循环里反复调用
WithTimeout创建新 ctx——timer 不会复用，可能触发大量 goroutine
为什么 context.Background() 不能随便当默认值用
它只是空 context，没有取消能力也没有 deadline，常被误用作“兜底参数”。一旦某个路径没传入有效 ctx，整条链路就失去取消能力，变成黑洞。
容易踩的坑：测试代码里写 fn(context.Background(), ...) 看起来能跑通，上线后遇到超时或中断请求就卡死；或者工具函数为了“兼容旧版”默认用 Background，结果调用方忘了传 ctx。
- 函数签名里不设默认值，强制调用方提供
ctx - 单元测试中用
context.TODO()表示“此处需补 ctx”，比Background更醒目 - HTTP handler 中从
r.Context()拿 ctx，而不是 fallback 到Background
最麻烦的不是写错一行代码，而是某次重构删掉了某层的 ctx 传递，而编译器完全不报错——得靠压测或真实中断才能暴露。所以从第一行函数开始，就要让 ctx 像空气一样自然存在，而不是可选配件。
