SuperAPI AI 工具集

go-context

通用与其它

查看项目

更新于 10-15 20:30

技能介绍

用途:该技能用于在 Go 项目中正确使用 context.Context,涵盖签名位置、取消与截止时间的传播,以及 context 值与其他传参方式的取舍。context 自 Go 1.7 起进入标准库。

主要能力与规范: 一、首参约定:使用 Context 的函数应将其作为第一个参数,例如 func F(ctx context.Context, /* other arguments */) error,或 func ProcessRequest(ctx context.Context, req *Request) (*Response, error)。 二、不把 Context 存进结构体:不要在 struct 中添加 Context 成员,而是在每个需要的方法上以参数传入;示例中给出错误写法 type Worker struct { ctx context.Context } 与正确写法 func (w Worker) Process(ctx context.Context) error。例外是方法签名必须匹配标准库或第三方库接口时。 三、不自定义 Context 类型:签名中只使用 context.Context,不要创建自定义接口(如带有 GetUserID 的 MyContext)。 四、数据放置顺序:优先函数参数,其次是接收者,再次是全局变量,最后才是 context 值;context 值仅适合请求范围数据,如请求 ID、追踪 ID、随请求流动的认证授权信息、截止时间与取消信号,不适合可选参数、可显式传递的数据、不随请求变化的配置。 五、常见模式:派生 context 后立即 defer cancel(),例如 ctx, cancel := context.WithTimeout(ctx, 5time.Second); defer cancel();检查取消可用 select 监听 ctx.Done() 并返回 ctx.Err();context 不可变,可安全地在多个共享同一截止时间与取消信号的并发调用中传递同一 ctx。

使用方式:相关细节位于 references/PATTERNS.md,适用于派生 context、检查取消、处理 HTTP 请求 context 或使用带类型的 context 值键时阅读。

相关技能:goroutine 协调见 go-concurrency;取消错误的包装与返回见 go-error-handling;接受 context 的接口设计见 go-interfaces;请求级日志见 go-logging。

限制:资料仅覆盖上述规范与模式,未提供安装命令、价格、平台支持或性能数据,这些信息暂未提供。