Go 并发最佳实践
将以下提示词粘贴到你的 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 双模式对照最佳实践写代码