GitHub 宣布調整 Actions API 與網頁介面回報工作流程執行次數的方式。過去系統會嘗試回傳精確的符合筆數,但當符合條件的紀錄超過 2500 筆時,查詢常常會逾時,結果只回傳逾時前已經找到的筆數,導致使用者看到的數字其實不準確,反而造成誤導。
技術上,分頁查詢每次最多仍是回傳 1000 筆資料,這點沒有改變;差別在於「符合條件的總筆數」這個統計數字,一旦超過 2500 筆,畫面與 API 回應就會直接顯示「2500+」,不再嘗試算出精確總數。如果開發者真的需要精確的數字,官方建議加上篩選條件以縮小筆數。
這個調整背後的重點是誠實優先於精確:與其給使用者一個因為逾時而中途截斷、看似精確卻其實錯誤的數字,不如老實顯示「已經超過 2500 筆」,讓人知道自己看到的是概數。這同時也減輕了 GitHub 伺服器在處理超大量查詢時的負擔,屬於典型的『犧牲一點精確度,換取系統穩定與資料誠實』的工程取捨。
對正在學程式的孩子與家長來說,這則比較偏工程與系統設計面,跟寫小遊戲、做網頁這類入門練習關係不大。不過背後的想法很值得學:與其給一個看似精確卻可能是錯的答案,不如老實說『資料太多、只能給概數』,這種誠實面對限制、而不是硬湊答案的態度,其實是寫程式與做任何研究都該有的習慣。
開發工具GitHub軟體工程