sync.Cond必须与已初始化的sync.Mutex或sync.RWMutex配合使用,Wait需在for循环中检查条件,Signal/Broadcast调用前须持锁修改状态,Wait会自动释放并重获锁。

sync.Cond必须和锁一起用,不能单独初始化
直接写 sync.NewCond(nil) 或传入未初始化的锁会 panic;它不管理锁生命周期,只依赖你传入一个已就绪的 *sync.Mutex 或 *sync.RWMutex。常见错误是把锁声明成值类型或忘记取地址:
- ❌ 错误:
var mu sync.Mutex; cond := sync.NewCond(mu)(传值,类型不匹配) - ❌ 错误:
cond := sync.NewCond(new(sync.Mutex))(new返回*sync.Mutex,但没初始化,可能触发未定义行为) - ✅ 正确:
mu := &sync.Mutex{}; cond := sync.NewCond(mu)或var mu sync.Mutex; cond := sync.NewCond(&mu)
所有对共享状态的读写、以及 cond.Wait() 调用,都必须在 cond.L 所指向的锁保护下进行——这是硬性契约,不是建议。
Wait 必须套在 for 循环里,if 会出问题
cond.Wait() 可能被虚假唤醒(spurious wakeup),也可能在唤醒后、你拿到锁之前,条件又被其他 goroutine 改回 false。所以永远不要写 if !ready { cond.Wait() }。
- ❌ 危险:
if len(queue) == 0 { cond.Wait() }—— 醒来时 queue 仍可能为空,后续操作 panic - ✅ 正确:
for len(queue) == 0 { cond.Wait() }—— 每次醒来都重新检查,确保逻辑安全 - 注意:这个循环里的条件判断必须和你在通知方修改的状态一致,比如消费者检查
len(queue),生产者就必须在改queue后调用Signal()或Broadcast()
Signal 和 Broadcast 不是“发消息”,而是“喊一嗓子”
Signal() 和 Broadcast() 不做状态校验,也不保证等待者立刻执行。它们只是把阻塞的 goroutine 从等待队列移出,让它们去竞争锁。谁先抢到锁、谁先检查条件、谁先处理,完全由调度器决定。
立即学习“go语言免费学习笔记(深入)”;
- ✅ 适合用
Signal():缓冲队列新增一个任务,只需唤醒一个 worker 处理(避免惊群) - ✅ 必须用
Broadcast():全局开关关闭、缓存批量失效、资源池重置——所有等待者都需要响应同一事件 - ⚠️ 常见误判:调用
Signal()后没看到 goroutine 响应,就怀疑 Cond 失效。其实更可能是:没人正在 Wait(还没启动),或刚醒就发现条件又不满足,又进了下一轮for循环
通知方也必须持锁:修改共享状态(如 queue = append(queue, item))和调用 Signal() 都得在 mu.Lock() / mu.Unlock() 之间,否则状态变更对等待者不可见。
Wait 会自动释放并重获锁,别自己 Unlock
cond.Wait() 内部做了两件事:先调用 c.L.Unlock(),挂起当前 goroutine;被唤醒后,再调用 c.L.Lock()。所以调用前你必须已持有锁,调用后锁仍被你持有——你不需要、也不能在 Wait() 前后手动 Unlock() 或 Lock()。
- ❌ 错误:
mu.Lock(); mu.Unlock(); cond.Wait()(Wait 前锁已释放,panic) - ❌ 错误:
mu.Lock(); cond.Wait(); mu.Unlock()(Wait 后锁已被重获,这里 Unlock 是多余且危险的) - ✅ 正确模式:
mu.Lock(); for !condition { cond.Wait() }; /* 此时 condition 为 true 且 mu 已锁定 */; mu.Unlock()
最容易被忽略的一点是:Wait 返回后,你拿到的是「刚被重获的锁」,不是「原来那个锁的状态」。如果多个 goroutine 竞争激烈,哪怕只差几纳秒,条件也可能被改写。所以 for 循环不是形式主义,是并发安全的底线。


















