除錯(Debugging)
Debugging
什麼是除錯?
- 找出並修正錯誤(bug)的過程
- 寫程式的時間中相當大的一部分
- 「解決問題」是核心能力
除錯的習慣一旦養成,開發時提出的問題本身也會改變。不再是抱怨「為什麼不行」,而是把範圍縮小為「做到哪一步都正常,從哪裡開始出問題」。重現 → 隔離 → 假設 → 驗證這四個步驟是基本,其中最先崩潰的是重現。每次出現都不一樣的症狀,還不到動手的階段,這是在提醒你必須先固定條件。
錯誤大致分為三類。語法錯誤連程式都無法執行,反而最容易處理;執行階段錯誤只會在特定輸入或特定資料量下出現;而代價最高的是邏輯錯誤。它不會出現任何錯誤訊息,程式看似正常運作,只是計算結果不對,除非親自驗算數字,否則誰也發現不了。若說測試與 QA 的工作是找出「有錯誤」,那麼除錯的工作就是查明錯誤出在哪裡並加以修正,兩者的角色就此區分。
請 AI 協助除錯時,要附上三樣東西:重現步驟、完整的錯誤訊息,以及出問題的檔案名稱。尤其錯誤訊息不要摘要,整段複製會比較好,因為堆疊追蹤(stack trace)中間列出的檔名與行號,往往比最後一行更關鍵。修正時也應一次只套用一項,才分得清哪一項真的有效。
現場最常見的失誤,是抱著「AI 會自己修好吧」的期待。只丟一句「不行」,AI 就會憑猜測重寫程式碼,連原本運作正常的功能也跟著改變。更危險的是把消除錯誤與解決問題混為一談。若放入把錯誤悄悄吞掉的程式碼,畫面雖然變乾淨,資料卻會持續累積錯誤。動手前若不先存下可以復原的節點,到第三次修改時,就沒人記得原本的程式碼長什麼樣子了。
「bug(臭蟲)」一詞廣為流傳,源自 1947 年葛麗絲·霍普(Grace Hopper)團隊在電腦中發現真正飛蛾的軼事,因此把消除錯誤的工作稱為「除錯」(debugging)。
我們以虛構的案例來說明。這是一家全體員工約 40 人的生活用品經銷商 A 公司的故事。營運團隊以 Vibe Coding 做了一套自動彙整月底結算檔案的內部工具,但按下上傳鈕卻毫無反應,這個狀況已持續兩週。過去每到月底,都是 2 人花兩天手動補齊。
- 營運團隊的金代理一開始只問 AI「按鈕就是按不下去」。他先後套用了四種不同的修正方案,症狀依舊,反而讓合計顯示也跑掉了。
- 組長要求從重現條件重新寫起。將描述固定為「上傳 3.2MB 的 12 月結算 Excel 檔,3 秒後畫面就停住」之後,才發現 1MB 的測試檔案其實能正常上傳。
- 金代理打開瀏覽器主控台,不摘要紅字錯誤,直接把 12 行全文複製貼上。AI 隨即指出 上傳容量限制 2MB 的設定那一行是原因。
- 每次只修正一件事。將上限調高到 20MB 儲存並確認後,把造成「以為當機了」誤會的等待畫面,另以新增進度顯示處理。
- 原本要花兩天的月底結算縮短為 40 分鐘,同樣症狀的重複詢問也從每月 3 件降為 0 件。之後團隊把「必須附上重現步驟加完整錯誤訊息才能向 AI 提問」的規則寫成文件留存。
Seung-tae Park
金鍾赫