goland 不会自动生成带超时的数据库 context 逻辑，仅支持函数签名补全和参数插入；超时值设定、withtimeout 创建位置及 cancel() 调用时机需手动决策。
GoLand 不会、也不能自动生成“带超时的数据库 Context”逻辑——它只帮你补全函数签名或插入 ctx 字段，而 context.WithTimeout 的创建位置、超时值设定、cancel() 调用时机，全得你手动决定。
为什么 GoLand 的自动补全对 WithTimeout 没反应
GoLand 的代码补全（比如输入 context.With 后按 Tab）能列出 WithTimeout、WithCancel 等函数，但它不会主动在你调用 db.Query 前插一句 ctx, cancel := context.WithTimeout(...)。原因很实在：
- 超时值不是常量，得根据业务场景定（比如用户查询 2s，后台导出 30s），IDE 无法猜
-
cancel()必须配defer，且只能在当前作用域调用；如果生成在错误层级（比如包级变量里），反而导致泄漏 - GoLand 不分析你是否漏传
ctx给db.QueryContext—— 它只管语法，不管语义是否连通
真正能用上的 GoLand 辅助操作
与其等“自动生成”，不如用好这几个确定可用的功能：
- 在函数参数里写
ctx context.Context，GoLand 会自动为后续调用（如db.QueryContext）补全第一个参数为ctx，前提是你的db变量类型是*sql.DB且项目已识别标准库 - 用 Live Template 快速插入超时模板：新建一个缩写为
ctxto的模板，内容为：ctx, cancel := context.WithTimeout($CTX$, $TIMEOUT$ * time.Second) defer cancel()
，其中$CTX$和$TIMEOUT$设为可跳转变量，输入一次就能批量复用 - 如果结构体里有导出字段
Ctx context.Context或CtxTimeout time.Duration，Alt+Insert → “Generate” → “Getter and Setter” 会生成类似func (s *Service) Query(ctx context.Context) error的方法骨架，但依然不会加WithTimeout调用
db.QueryContext 调用时最容易漏掉的三件事
即使你手写了 context.WithTimeout，下面这些点在线上仍高频出问题：
- 用了
db.Query()而不是db.QueryContext(ctx, ...)—— 这会让整个超时逻辑完全失效，因为Query()根本不读 ctx -
ctx来源错误：比如在 HTTP handler 里直接写context.Background()，而不是用req.Context()，导致请求被 cancel 时，DB 查询还在跑 - 忘记在
rows.Close()后检查rows.Err()：超时错误实际发生在rows.Next()或rows.Close()阶段，不查这个返回值，就捕获不到context.DeadlineExceeded
最常被忽略的其实是生命周期匹配：HTTP 请求的 ctx 生命周期和 DB 查询的 ctx 必须是同一个实例，不能在中间层重新 WithTimeout 却没透传到底层 QueryContext。一旦断链，超时就只在某一层生效，底下照旧卡死。
