本文详解 Go 中使用 WaitGroup 与 channel 进行并发读写的常见陷阱，重点解决因 break 误跳出循环导致的 sync: negative WaitGroup counter panic，并提供简洁、健壮的替代方案。

本文详解 go 中使用 waitgroup 与 channel 进行并发读写的常见陷阱，重点解决因 `break` 误跳出循环导致的 `sync: negative waitgroup counter` panic，并提供简洁、健壮的替代方案。

在 Go 并发编程中，通过 channel 协调生产者（writer）与消费者（reader）是经典模式。但若对控制流和同步原语理解不深，极易引发运行时 panic —— 其中最典型的就是 sync: negative WaitGroup counter。该错误并非 WaitGroup 被多次调用 Done()，而是 break 仅退出了 select 的 case 分支，而非外层 for 循环，导致 wgread.Done() 被重复执行。

回顾原始代码问题所在：

go func() {
    for ; ; {
        select {
        case chanoutput, ok := <p>当 channel 关闭后，ok == false，wgread.Done() 执行一次，但 break 并未终止 for ; ; {}，循环继续——下一轮 select 再次从已关闭 channel 接收，ok 仍为 false，再次执行 wgread.Done()，造成 WaitGroup 计数器减至负值，触发 panic。</p><p>✅ 正确做法：<strong>使用 range 遍历 channel</strong>，它天然感知 channel 关闭，并在迭代结束后自动退出循环；同时配合 defer wgread.Done() 确保仅执行一次：</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill4681" title="NoChat Channel"><img
														src="https://img.php.cn/upload/skill/000/000/081/179015764214376.jpg" alt="NoChat Channel" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill4681" title="NoChat Channel" class="overflowclass">NoChat Channel</a>
													<p class="overflowclass">通过 NoChat 实现代理间后量子端到端加密通信，具备信任等级、代理发现和 OpenClaw 的服务器盲隐私。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill4681" title="NoChat Channel" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><pre class="brush:php;toolbar:false;">wgread.Add(1)
go func() {
    defer wgread.Done() // 安全：函数退出时保证调用一次
    for chanoutput := range somechan { // channel 关闭时自动退出循环
        fmt.Println(string(*chanoutput))
    }
    fmt.Println("DONE") // 此处执行表示消费完成
}()
wgread.Wait()

? 进阶优化：若消费者逻辑简单且无需与其他 goroutine 并发执行，甚至可省略 goroutine 和 WaitGroup，直接同步消费：

// 替代整个 wgread 块
for chanoutput := range somechan {
    fmt.Println(string(*chanoutput))
}
fmt.Println("DONE")

⚠️ 注意事项：

• 永远避免在 select 的 case 中对 ok == false 使用裸 break 来退出外层循环；应改用 return、goto 或 range。
• defer wg.Done() 是比手动 wg.Done() 更安全的习惯，尤其在含多出口（如 error return）的函数中。
• 生产者端务必在关闭 channel 前确保所有发送已完成（例如在 for 循环结束后 close(somechan)），否则可能引发 panic "send on closed channel"。

总结：Go 的 channel 与 range 是高度协同的设计。善用 for v := range ch 不仅语义清晰、代码简洁，更能从根本上规避因手动控制流失误导致的同步错误。