go 的 container/heap 仅是堆操作工具包，非开箱即用的优先队列；需手动实现 len、less、swap、push、pop 五方法，且 push/pop 必须用指针接收者，调用时传地址，否则修改副本导致无反应。
Go 的 container/heap 不是优先队列，它只是堆操作工具包；你得自己写五种方法、传指针、调 Init，漏一个就 panic。
为什么 heap.Push 没反应？接收者必须是指针
常见错误是把 Push 和 Pop 的接收者写成值类型（比如 func (h TaskHeap) Push(...)），结果 *h = append(*h, x) 修改的是副本，底层数组完全没变——队列始终为空。
-
Push和Pop必须用指针接收者：func (h *TaskHeap) Push(x interface{}) -
Len、Less、Swap可以用值接收者（更高效），但Push/Pop不行 - 调用时也必须传地址：
heap.Push(&pq, task)，不是heap.Push(pq, task)
Less 写反了会怎样？最小堆和最大堆只差一个符号
Less(i, j) 返回 true 时，i 会被“提”到更靠近根的位置。所以：
- 最小堆 → 小的优先 →
return h[i].Priority - 最大堆 → 大的优先 →
return h[i].Priority > h[j].Priority - 别在
Less里调函数、查 map 或做任何耗时操作，它会在每次上滤/下滤中被反复调用 - 如果字段可能为
nil（比如*time.Time），先判空再比较，否则 panic
heap.Init 和 heap.Push 到底谁该什么时候调？
heap.Init 是批量建堆，不是“初始化队列”的仪式感操作；误用会导致性能归零甚至丢数据。
- 新建空堆（如
h := &IntHeap{}）可直接heap.Push，不用先Init - 已有无序切片（如从 DB 读出的
[]Task），才需要heap.Init(&h)一次性整理 -
heap.Push内部已自动完成上滤（sift-up），不需要、也不应该再手动Init - 更新某个元素字段后（比如改了任务的
Priority），要用heap.Fix(&h, i)，不是Init
并发访问 container/heap 会怎样？它不带锁
container/heap 是纯函数式工具，内部不存状态、不加锁、不维护 goroutine 安全性。多个 goroutine 同时 Push 或 Pop，大概率触发 data race 或堆结构损坏。
- 最简方案：用
sync.Mutex包一层，所有操作（Push/Pop/Peek）都在锁内完成 - 别用
chan封装来“假装线程安全”——通道只排队调用，底层切片仍被并发修改 - 避免在锁内做耗时操作（如 HTTP 请求、DB 查询），否则整个队列阻塞
- 如果真要高并发，等
heap/v2（已发布）或用第三方带索引/并发支持的实现
最容易被忽略的点：空切片不能为 nil，Len() 返回负值或 panic；Pop 必须返回最后一个元素再缩容，顺序反了会越界；Less 的语义必须严格对应业务调度逻辑——比如“最早执行时间优先”，就得比 execAt.Before(...)，而不是字段名直觉判断。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
