Agentic Research

Debug(除錯)

又稱:除錯 · debugging · traceback · 錯誤訊息怎麼看 · stack trace

讀懂錯誤訊息、找出真正出問題的那一行,然後只改那裡。

你會在什麼時候遇到它

這是新手報酬率最高的一項技能,而且不需要會寫程式。九成安裝失敗的答案已經印在畫面上:最後一行講的是什麼錯,倒數幾行講的是哪個檔案第幾行。不會讀它,你就只能重裝、換工具、或整段丟給 AI 猜 —— 每一種都比讀三行慢。

打個比方

像看醫師的檢查報告,而不是只知道「你不舒服」。報告最後一行是診斷,上面幾頁是它怎麼查出來的。多數人從第一頁開始讀,讀到中間就放棄 —— 而答案在最後。

最小範例

Traceback (most recent call last):
  File "/app/main.py", line 8, in <module>
    main()
  File "/app/main.py", line 5, in main
    text = read_config("settings.ini")
  File "/app/read.py", line 2, in read_config
    return open(path).read()
FileNotFoundError: [Errno 2] No such file or directory: 'settings.ini'

讀法只有三招:先看最後一行(FileNotFoundError,以及是哪個檔案找不到);再看它上面兩三行(真正出事的位置是 read.py 第 2 行,不是 main.py);然後去確認那個檔案在不在、路徑寫得對不對。整段文字裡只有這三處有用。

最常搞錯的地方

  • 從第一行開始讀。Python 的 traceback 是「最後一行才是結論」,前面全是過程;Node.js 的堆疊追蹤也類似。把它當成一段要從頭讀的文章,就會在中間失去耐心。
  • 看到錯誤就立刻重裝工具或重開機。錯誤訊息裡通常已經寫明缺什麼、在哪一行;重裝只是把同一段訊息再刷一次。
  • 把整段錯誤丟給 AI 之前沒有遮掉機密。錯誤訊息常常原樣印出你的 Authorization 標頭或環境變數。

相關詞條

下一步