SuperAPI AI 工具集

go-concurrency

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:在编写并发 Go 代码时提供规范与参考,涵盖 goroutine、channel、mutex、原子操作与线程安全保证,也适用于并行化任务、修复数据竞争等问题。

主要内容与规范:

  • 协程生命周期:启动 goroutine 时必须明确其何时或是否退出,每个 goroutine 需要可预测的结束时间或取消信号,代码应能等待其结束;禁止在 init() 中启动 goroutine,改为暴露 Close、Stop、Shutdown 等生命周期方法;同步范围尽量限制在函数内。示例使用 sync.WaitGroup.Go(Go 1.25+)与 wg.Wait()。
  • 通过通信共享内存:默认使用 channel 传递所有权与编排,当问题是保护共享数据结构(如缓存、计数器)时退回 sync.Mutex / sync.RWMutex。
  • 优先同步函数:便于推理生命周期、避免泄漏与竞争、易于测试,并让调用方自行决定并发。
  • 互斥锁零值有效,几乎不需要指针;不要内嵌 mutex,使用命名 mu 字段。
  • 指定 channel 方向,防止错误并表达所有权。
  • channel 大小建议为 0 或 1,其他大小需要说明理由及阻塞时的行为。
  • 原子操作使用 atomic.Bool、atomic.Int64 等类型安全形式(sync/atomic 自 Go 1.19 起,或 go.uber.org/atomic)。
  • 当线程安全性不明显时,应记录并发假设(如读操作是否安全、API 是否提供同步)。

资源路由:references/GOROUTINE-PATTERNS.md 用于启动、停止、等待 goroutine;references/SYNC-PRIMITIVES.md 用于选择互斥锁、原子、channel 和一次性原语;references/BUFFER-POOLING.md 用于 channel 或 sync.Pool 复用;references/ADVANCED-PATTERNS.md 用于工作池、管道、errgroup 与取消密集型模式。

测试与工具:用 go.uber.org/goleak 检测 goroutine 泄漏;兼容性说明为原子示例可能在可用时使用标准库类型化原子,或项目已依赖 go.uber.org/atomic 时使用后者。

相关技能:上下文传播参考 go-context,错误处理参考 go-error-handling,防御性加固参考 go-defensive,接口设计参考 go-interfaces。

限制:本文档为技能说明,未提供完整示例代码之外的运行环境、版本要求细节或价格信息。