GoLand不会自动添加context.Context参数，需手动在函数签名中加入并检查ctx.Err()或select监听Done()；WithValue的key应使用私有类型防冲突；WithCancel/Timeout后必须defer cancel()；测试用context.Background()即可。
GoLand 里 context 参数不是自动加的，得手动补
GoLand 不会在函数签名里自动插入 context.Context 参数，哪怕你刚用 WithTimeout 创建了上下文。它不会猜你要把 ctx 传给谁——这得你自己决定传给哪个函数、在哪儿加参数。
常见错误是：写了 ctx, cancel := context.WithTimeout(...)，然后直接调用 doSomething()，但 doSomething 没声明接收 ctx，也没监听 ctx.Done()，结果超时或取消信号完全没起作用。
实操建议：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在需要受控的函数（比如 IO、RPC、DB 查询）签名开头显式加上
ctx context.Context参数 - 如果函数已存在，把光标停在函数名上按
Alt Enter→ 选「Add parameter」，输入ctx context.Context - 别只加参数，后续必须在函数体内检查
select或if ctx.Err() != nil，否则等于没加
WithValue 的 key 类型别用 string，用私有类型防冲突
用 context.WithValue(ctx, "user_id", 123) 看似简单，但多个包都用相同字符串 key 时会互相覆盖，而且编译期无法检查 key 是否拼错。
Go 官方文档和 net/http、database/sql 等标准库都用自定义未导出类型作 key，这才是安全写法。
实操建议：
- 定义 key 时用
type ctxKey string+ 私有变量，例如：const userIDKey ctxKey = "user_id" - 传值用
context.WithValue(ctx, userIDKey, 123)，取值时强制类型断言：id := ctx.Value(userIDKey).(int) - 如果要传多个关联字段（如 user ID、role、tenant），优先打包成结构体再传，而不是链式调用多次
WithValue
生成 WithCancel / WithTimeout 模板后，cancel 必须 defer 调用
GoLand 的「Generate → Context creation」能快速插入 ctx, cancel := context.WithTimeout(...)，但它不会帮你加 defer cancel()。漏掉这句会导致 goroutine 泄漏、资源不释放，尤其在 HTTP handler 或循环任务中非常危险。
实操建议：
- 每次调用
WithCancel、WithTimeout、WithDeadline后，下一行立刻写defer cancel() - 如果函数有多个 return 点，
defer仍能保证执行；不要写成if err != nil { cancel(); return }这类手动调用 - 注意：
cancel()是幂等的，可重复调用，但没必要——defer一次就够了
测试里用 context.Background() 就够了，别 mock Context 接口
有人想给 Context 写 mock 实现来控制 Done() 通道行为，其实大可不必。标准库提供了更轻量、更可靠的方式。
实操建议：
- 单元测试中，直接用
context.Background()或context.TODO()作为入参，足够覆盖逻辑分支 - 需要模拟超时场景？用
context.WithTimeout(context.Background(), 1*time.Millisecond)，然后time.Sleep(2 * time.Millisecond)触发ctx.Err() - 需要模拟取消？用
ctx, cancel := context.WithCancel(context.Background())，调用cancel()后立刻验证ctx.Err() == context.Canceled
真正容易被忽略的是：context 的控制力完全依赖下游函数是否主动监听 Done() 或轮询 Err()。GoLand 可以帮你生成代码骨架，但没法替你写那几行 select 或 if ctx.Err() != nil ——这部分必须手写，且每层都要检查。漏一层，整条调用链就失控。
