Vibe Coder
Debug 與錯誤診斷工作流:AI 輔助除錯 SOP,五分鐘定位問題
Debug 與錯誤診斷工作流:AI 輔助除錯 SOP,五分鐘定位問題
不知道問題在哪就亂試,每次讓 AI 猜都要花時間來回。這篇教你系統化的除錯工作流:先定位問題在哪一層,再用固定格式精確描述給 AI,一次就解決,而不是來回猜十次。
你將學到什麼
縮小範圍的心智模型
所有 Debug 的本質,都是不斷縮小可能有問題的範圍。
五層錯誤分類
環境、設定、程式碼、API、前端,先分類再找線索。
AI 輔助除錯 SOP
分類、收集、自查、問 AI、驗證,五個步驟定位問題。
讓偶發 bug 穩定出現
找到最小復現案例,AI 才能針對性地修正。
為什麼 Vibe Coder 需要系統化的 Debug 工作流
隨機試錯很貴,不知道問題在哪就亂試,每次讓 AI 猜都要花掉一輪對話。系統化先定位再修,才能一次解決。給 AI 精確的資訊才有精確的答案,比起只說程式壞了,說出第 23 行出現 KeyError、API 回傳格式變了,AI 才能直接給解法。能穩定復現的 bug 才修得掉,偶發的 bug 最難處理,要先想辦法讓它每次都出現。
Debug 的心智模型:縮小範圍
所有 Debug 的本質,都是不斷縮小可能有問題的範圍,直到找到最小的問題根源。
| 步驟 | 怎麼做 |
|---|---|
| 問系統上次是不是正常的 | 是的話想想最近改了什麼;否的話問題可能在初始設定 |
| 找最小復現案例 | 能讓 bug 出現的最簡單輸入是什麼,去掉所有不相關的部分 |
| 用二分法定位 | 把程式分成兩半,確認 bug 在哪一半,再對那一半繼續二分 |
| 先讀錯誤訊息再行動 | 多數 bug 的答案就在錯誤訊息裡,花時間仔細讀比亂試有效 |
五層錯誤分類
| 層次 | 錯誤特徵 | 常見原因 |
|---|---|---|
| 環境層 | 本機跑得起來,別人跑不起來 | 套件版本不同、Python 版本、系統或路徑差異 |
| 設定層 | 錯誤訊息提到設定或金鑰相關字眼 | 金鑰沒設、格式錯誤、打錯字 |
| 程式碼層 | Traceback 指向自己的檔案 | 邏輯錯誤、型別錯誤、空值沒處理 |
| API 層 | 狀態碼是 4xx 或 5xx、逾時 | 認證失敗、格式錯誤、呼叫次數超過限制 |
| 前端層 | 瀏覽器出現紅字、功能沒反應 | JavaScript 錯誤、跨網域被擋、API 沒打出去 |
AI 輔助除錯 SOP
| 步驟 | 要做的事 |
|---|---|
| 分類 | 用五層分類判斷問題在哪一層,決定去哪裡找資訊 |
| 收集 | 複製完整錯誤訊息,記下出錯的檔案和行號,記錄觸發條件 |
| 自查 | 對照五層分類的常見原因快速自查,很多不用問 AI 就能解決 |
| 問 AI | 把收集到的資訊填進診斷格式模板,給 AI 精確的問題描述 |
| 驗證解法 | 先理解 AI 給的解法在做什麼,再執行,確認沒有引入新問題 |
| 記錄踩坑 | 花幾分鐘記錄問題、原因與解法,存進自己的踩坑記錄庫 |
復現步驟:讓 Bug 穩定出現
找最小輸入,能觸發 bug 的最小、最簡單輸入是什麼,去掉所有不必要的資料。記錄觸發條件,是每次都會出現,還是偶爾才出現,在什麼環境下出現。隔離外部依賴,用替身取代 API 呼叫,確認 bug 是自己的程式碼本身,還是外部服務的問題。
給 AI 的診斷格式模板
Problem summary:
Layer: code / API / frontend
Error message: [paste full traceback]
File: [filename] Line: [line number]
Failing code: [the exact line or function]
Trigger: I was doing [describe action]
Input: [if applicable]
Already tried: [list what you've tried]
Environment: Python [version], OS: [Mac/Windows/Linux]
延伸學習
ChatGPT 很強,但真正讓你下班的是 Google
六小時完整實錄。從「AI 很厲害,為什麼你還是每天加班」這個問題出發,把 Google Workspace 當成真正的工作平台重新設計一次流程 ── Sheets 的資料結構、Drive 與 Docs 的文件流、Gmail 與 Calendar 的通知系統,再用 Apps Script 讓它自己跑起來,最後收斂成一張屬於你自己的 AI 工作能力地圖。
NT$ 4,599
知識變現切割地圖(高清版下載,不含講義)
《知識變現切割地圖》的高清完整版。一張圖把語氣、心理、內容、產品、再利用五層模組攤在同一個平面上,讓你回頭盤點已有內容、規劃新的轉化節奏。課程附上地圖本身的完整解說與應用指南,教你怎麼讀這張圖、從哪一層開始用。完整版 PDF 可下載,放大看細節不會糊。
NT$ 680

