程式碼解釋與除錯

🍽 這道菜在做什麼

學寫程式最磨人的時刻，往往不是寫不出來，而是「程式跑不動、報了一串看不懂的紅字、卻完全不知道從哪查起」。對自學者、學生、剛入行的初階工程師來說，這種卡關特別折磨——你可能對著一個 TypeError 盯了半小時，搜尋引擎丟出一堆英文討論串又看不太懂，最後只能把整段程式刪掉重寫，連自己到底錯在哪都沒搞清楚。這道配方就是要把「看不懂的程式碼或錯誤訊息」翻譯成你聽得懂的白話，順便把 bug 抓出來、教你怎麼修、再提醒你下次別再踩同一個坑。

最需要它的人，是身邊沒有資深前輩可以隨時問的學習者。傳統上你卡關時要嘛苦等同學有空、要嘛在論壇發問等好幾小時才有人回，而且回覆常常假設你已經懂很多。這道配方等於給你一位 24 小時待命、不會嫌你問題太菜、願意逐段拆給你聽的程式家教，三分鐘內就能讓你從「完全卡死」變成「知道問題在哪、也知道怎麼修」。

它的價值不只在於「幫你修好」，更在於「讓你看懂為什麼」。每一次卡關都是一次學習機會，這道配方把原本只會讓你挫折的錯誤訊息，變成一堂針對你當下程度量身打造的迷你課。

為什麼這樣設計

這道配方的提示詞看起來簡單，但每一條都對應一個學習者的真實需求。第一項「用白話逐段解釋它在做什麼」，是因為很多初學者其實連自己貼上的程式碼都沒完全讀懂——可能是抄來的範例、可能是上次寫的自己也忘了。先把邏輯逐段講清楚，後面的除錯才有意義，否則就算改好了你也是知其然不知其所以然。

第二項把除錯拆成「問題在哪、為什麼、怎麼修」三層，這個順序很關鍵。直接丟一份修正版程式碼給你，學習效果接近零；但先告訴你錯在哪一行、再解釋背後的原理、最後才給修正碼，你就能把這次經驗內化成可遷移的理解。第三項「避免再犯的小建議」更是這道配方的靈魂——它逼 AI 從這一個具體錯誤，抽象出一條通用的好習慣，例如「用變數前先檢查它存不存在」，讓你修一個 bug 學到一個原則。

第四項「程式碼保留原樣、用繁體中文解釋」也很實用：保留原碼讓你能對照前後差異，看清楚到底改了什麼；繁體中文解釋則降低語言隔閡，讓你把腦力全花在理解邏輯上，而不是邊查程式概念邊查英文單字。想看更多寫給初學者的提示配方，可以逛逛 AgentAI 食譜庫。

怎麼用

第一步，複製上方提示詞，貼到 Claude、ChatGPT 或 Gemini 任一個對話框。純對話即可，不需要任何外掛或網頁搜尋。

第二步，填入程式語言（例如 Python、JavaScript、Java），然後把你的程式碼貼進「{貼上}」的位置。一個關鍵小撇步：如果程式有報錯，務必連同完整的錯誤訊息一起貼上去，不要只貼程式碼。錯誤訊息裡通常藏著最關鍵的線索——是哪一行、什麼型別的錯、卡在哪個函式，這些資訊能讓 AI 一針見血，省去大量來回猜測。這正對應步驟卡的「貼程式碼」。

第三步，按 Enter，AI 會逐段白話解釋這段程式在做什麼，接著指出 bug 位置與原因，並附上修正後的完整程式碼，最後給你一條避免再犯的建議。

第四步，最重要：別急著複製貼上。先把它的解釋讀懂，再回頭對照修正前後的差異，確認你真的明白「為什麼這樣改就對了」。看懂了之後再把修正版貼回你的編輯器測試。這道配方的目的不只是讓程式跑起來，而是讓你下次遇到類似問題能自己解。

調整技巧

拿到解釋後，可以繼續用講的把這次學習榨乾。如果解釋裡有名詞你不懂，直接追問「undefined 跟 null 有什麼差別，舉個生活化的例子」，AI 會就你的程度再講細一點。

照 variations 的「重構版」，你可以接著說「在不改變功能的前提下，把這段程式改得更乾淨、加上適當註解、變數名取得更好懂」，學習怎麼把「會動的程式」變成「好讀的程式」。照「教學版」，請它「根據我這次犯的錯，出三題由易到難的練習題，先別給答案」，用刻意練習鞏固這個概念，等你寫完再貼回去請它批改。想把學程式的整套流程串起來，可以參考 工作流範本，把「看懂 → 重構 → 練習 → 複習」排成固定節奏。

注意事項

最大的地雷是「盲目複製」。AI 給的修正碼大多數時候是對的，但它看到的只是你貼上的那一小段，不一定掌握你整個專案的脈絡——它修好的局部，有可能跟程式碼其他地方的邏輯衝突，或引入新的副作用。所以修正版貼回去後一定要實際執行、自己測試，不能假設它必然正確。看懂再貼上，永遠是這道配方的鐵則。

另外有兩件事要特別當心。其一，不要把含有密碼、API 金鑰、資料庫連線字串、客戶個資的程式碼直接貼上線上 AI 工具，貼之前先把這些敏感資訊換成假值。其二，AI 偶爾會「很有自信地講錯」，尤其在冷門語言、舊版本語法或特殊框架的情境下——它的解釋是很好的學習起點，但若牽涉到正式上線、金流、資安的程式，務必再對照官方文件確認，AI 是你的學習助手，不是最終的權威。

台灣情境案例

一位在補習班自學前端的大學生，做作業時 JavaScript 一直噴 TypeError: Cannot read properties of undefined，他完全看不懂。把語言寫「JavaScript」、連同程式碼和完整錯誤訊息一起貼進去，AI 逐段解釋他的邏輯，指出「你在資料還沒從 API 回來時就去讀它的屬性，這時它是 undefined」，給了加上判斷的修正碼，最後提醒「存取物件屬性前，先確認資料存不存在」。他不只當晚交出作業，還真的把這個觀念記住了，後續類似錯誤再也沒卡過。

另一個例子：台南一位開小型網拍的店主，想自己寫一段 Python 小腳本把訂單 Excel 自動整理，跟著網路教學拼拼湊湊卻一直報錯。她把腳本和錯誤貼進去，AI 發現是她讀檔的路徑寫錯加上漏裝套件，逐步教她怎麼修，還順手解釋每一行在做什麼。她從「完全不會寫程式」變成「看得懂自己這段腳本」，之後遇到小問題也敢自己改了。

延伸用法

這道配方是學程式路上最常開的工具之一，能往很多方向延伸。看懂並修好之後，可以請 AI「把這段邏輯改寫成函式、方便我重複使用」，順便學模組化；想加深理解，可以請它「畫出這段程式的執行流程，用文字步驟列出來」。

要系統性地補強某個觀念，可以搭配 產生器工具 生一份針對你弱項的練習題庫，反覆操練。如果你正在從零自學一門語言，建議用一條 工作流 把「跟教學寫 → 卡關用這道配方解 → 重構 → 出題自測」固定成每天的學習循環，進步會比東學一塊西學一塊快得多。更多適合學生與自學者的提示配方，都收在 AgentAI 食譜庫，可以挑著用。

材料

• AI 對話工具（Claude／ChatGPT／Gemini）
• 你的程式碼或錯誤訊息

步驟

1. 貼程式碼：連同錯誤訊息一起貼。
2. 看解釋與修法：逐段白話＋修正版。
3. 學起來：記住避免再犯的建議。

配方本體（可複製帶走）

# 任務
請幫我看這段程式碼：
1. 用白話逐段解釋它在做什麼
2. 如果有錯誤/報錯，指出問題在哪、為什麼、怎麼修（給修正後的程式碼）
3. 給一個「避免再犯」的小建議
4. 用繁體中文解釋，程式碼保留原樣

程式語言：{語言}
程式碼 / 錯誤訊息：
{貼上}

試吃報告

變化版

• 重構版：請它把程式碼改得更乾淨、加註解。
• 教學版：請它出 3 題練習鞏固這個概念。

你可能也想看