context 包在 API 边界和 goroutine 之间传递取消信号、截止时间和请求作用域的值。它是控制操作生命周期的标准机制——特别是用于取消工作和通过函数调用链传播超时。
A request starts work across many goroutines/functions (DB query, API call, etc.).
If the client disconnects or a timeout hits, you want to CANCEL all that work
so goroutines don't keep running uselessly (wasting resources / leaking).
→ context propagates the "stop now" signal down the entire call chain.
ctx := context.Background() // the root context (top of the tree)
ctx := context.TODO() // placeholder when unsure
// with a timeout — auto-cancels after the duration
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel() // ALWAYS call cancel to release resources
// with manual cancellation
ctx, cancel := context.WithCancel(context.Background())
// call cancel() to signal cancellation
// with a deadline (specific time)
ctx, cancel := context.WithDeadline(ctx, time.Now().Add(time.Minute))
WithTimeout/WithDeadline/WithCancel 派生一个可以被取消的子 context；你必须 defer cancel() 来释放其资源。
func doWork(ctx context.Context) error {
for {
select {
case <-ctx.Done(): // fires when cancelled or timed out
return ctx.Err() // returns context.Canceled or DeadlineExceeded
case work := <-jobs:
process(work)
}
}
}
函数检查 ctx.Done()（一个在取消时关闭的 channel）并及时停止——这就是取消实际传播的方式。
// ctx is conventionally the FIRST parameter, named ctx
func handler(ctx context.Context, ...) {
data, err := fetchFromDB(ctx, id) // pass it down — DB call honors cancellation
}
func fetchFromDB(ctx context.Context, id int) (...) {
row := db.QueryRowContext(ctx, ...) // standard-library APIs accept context
}
Context 作为第一个参数向下流经调用栈，因此取消信号会到达每一层（包括接受 context 的标准库 DB/HTTP 调用）。
ctx = context.WithValue(ctx, requestIDKey, "abc-123") // attach a value
id := ctx.Value(requestIDKey) // retrieve it downstream
// ⚠️ for request-scoped metadata (request IDs, auth) — NOT for passing regular params
context 包是编写健壮的、生产级 Go 服务的基础——它是跨 goroutine 和 API 边界处理取消和超时的标准、习惯用法。
它的主要价值在于防止浪费工作和资源泄漏：当客户端断开连接、截止时间已过或服务器关闭时，context 会传播取消信号，使为该请求生成的所有 goroutine 和操作立即停止，而不是继续无用地运行（这是防止 goroutine 泄漏的关键防线）。
它在真实的 Go 代码中无处不在——HTTP 服务器、数据库调用、gRPC 和大多数网络库都接受 context.Context 作为第一个参数。
理解如何创建 context（WithTimeout/WithCancel）、响应取消（<-ctx.Done()）、必须调用 cancel() 的规则以及通过调用链传递 context 的约定，对于任何认真的 Go 后端工作和常见的面试话题都是必不可少的。