核心概念
最後更新
本頁把每個排程問題對應到回答它的頁面，說明排隊中的任務存放在哪裡，並列出與相關 Go 專案的關係；以下規則全部位於
github.com/pardnchiu/go-queue/core。該看哪一頁
| 問題 | 頁面 |
|---|---|
| 哪個任務先執行？優先權從哪來？ | 優先權等級 |
| 低優先權任務會不會永遠等不到？ | 防飢餓自動升級 |
| 一個任務最多能跑多久？ | 逾時推算 |
| panic、逾時、回傳錯誤時會怎樣？重試怎麼運作？ | 執行與重試 |
什麼時候可以呼叫 Enqueue、Start、Shutdown？ | 佇列生命週期 |
任務路徑速覽
Enqueue依 Preset 決定優先權與逾時，再把任務放進單一有界最小堆（min-heap）- 閒置的 Worker 呼叫
Pop；每次Pop都會先升級等待過久的任務 - Worker 在逾時 ctx 下執行任務，並攔截 panic
- 失敗且仍有重試額度的任務以
PriorityRetry重新入堆；其餘結果都以一筆slog事件收尾
任務存放在哪裡
go-queue 是程序內（in-process）的優先權任務佇列：有界 worker pool 與最小堆都在你的 Go 程式內，模組只引用標準函式庫（
go.mod 沒有 require）。排隊中的任務只存在記憶體、不會持久化，程序結束時仍在堆裡的任務不會執行。下表列出 go-queue 與相關 Go 專案的關係。相關 Go 專案
各專案的描述取自其 GitHub repository。
| 專案 | 定位 | 與 go-queue 的關係 |
|---|---|---|
hibiken/asynq | 以 Redis 為後端的分散式任務佇列 | go-queue 把任務放在程序記憶體，不需要外部服務 |
riverqueue/river | 存放在 Postgres 或 SQLite 的背景工作 | go-queue 把任務放在程序記憶體，不需要資料庫 |
RichardKnop/machinery | 透過 Redis、AMQP、AWS SQS 等 broker 分散式傳遞訊息的非同步任務佇列 | go-queue 在單一程序內執行，不需要 broker |
panjf2000/ants、alitto/pond | 程序內的 goroutine pool | 部署型態相同；go-queue 以優先權堆排程，提供五級優先權、防飢餓自動升級、依 Preset 推算的單一任務逾時與選用的重試 |
susamn/rio | 以優先佇列為基礎、具逾時與重試的工作排程器 | 部署型態相同；go-queue 依具名 Preset（Config.Preset）決定優先權與逾時，每種結果都以固定的 slog 事件回報 |
oleiade/lane | 泛型的優先佇列、佇列、堆疊與雙端佇列資料結構 | lane 提供資料結構；go-queue 是任務執行器，Worker、逾時與重試建立在自身的 container/heap 最小堆上 |