Agent Skills
返回列表
💻

Go 并发最佳实践

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-concurrency。

技能介绍

要解决什么问题

Go 的 goroutine 便宜,但每个未收口的协程都是潜在泄漏点:进程跑着跑着 runtime.NumGoroutine() 只增不减,直到 OOM 或行为诡异。团队在 PR 里加并发时,还常见 context 没往下传、mutex 护不住共享状态、receiver 侧关 channel 导致 panic。大规模代码库要做并发审计时,单线程扫一遍又慢又容易漏模式。

技能如何工作

技能以「先正确、再不漏、最后才谈性能」为立场,提供三种模式:

  • Write mode:按顺序落地 goroutine、channel、sync 原语、worker pool 与 pipeline,并遵循「每个 goroutine 有明确退出」「channel 只由发送方关闭」「channel 上送副本而非指针」等原则。
  • Review mode:对着 diff 查 goroutine 泄漏、缺失的 context 传播、所有权边界与无保护的共享状态。
  • Audit mode:可按文档中的「Parallelizing Concurrency Audits」拆成最多 5 路并行子代理扫仓库,再汇总成一份报告;在 Claude Code 上需用 ultracode 显式启用多代理编排。

文档还区分 channel 传递所有权与 mutex 隐式共享的取舍,并指向同系列的 context、安全、排障与优雅关闭等技能;Go 1.26 实验性 goroutine leak profile 仅作 GOEXPERIMENT=goroutineleakprofile 下的补充手段,生产排查仍应保留 goleak、/debug/pprof/goroutine、-race 等既有工具。

适用边界

它是并发规范与审查导向,不是通用 Go 语法教程;性能热点、false sharing 等应交给同仓库的 golang-performance 技能。公司内若有显式覆盖本社区技能的定制版本,以社区约定为准优先采用。

使用场景

  • 为新的批处理服务编写 worker pool,需要保证每个 goroutine 在 context 取消时能退出
  • Review 同事 PR 中新增的 `go func()`,确认 diff 里没有遗漏 WaitGroup 或 done channel
  • 对 monorepo 里所有 HTTP handler 与后台任务做并发审计,产出统一问题清单
  • 重构 pipeline:用有向 channel 串联阶段,并检查是否只有发送方关闭 channel

适合人员

  • 维护高 QPS 后端、需要在发版前排查 goroutine 泄漏的 Go 后端工程师
  • 负责合并并发相关 PR、要按 checklist 查 context 与共享状态的 Tech Lead
  • 平台组同学在 CI 里对改动包做 AI 辅助并发审查(可配合同系列 golang-continuous-integration)
  • 从单体迁到多 goroutine 编排的同事,需要 Write/Review 双模式对照最佳实践写代码