歸納是為了更好地理解。受 jQuery 的 Discussion 頁面啟發,作者發現同事來求助時,往往都是很小的問題——他們並不是缺乏解決問題的知識,而是缺少找到問題的方法。人總是樂於助人的,但如果有個好的查錯流程,很多簡單的小問題根本不必麻煩別人。
標籤沒閉合、屬性引號漏了、巢狀錯了,會讓 DOM 結構變成你完全預期不到的樣子。而 JavaScript 對 DOM 的操作全都建立在這個結構之上——地基歪了,上面的程式碼再對也沒用。先做一次 HTML 驗證,往往三分鐘內就能找到問題。
打開 firebug 或瀏覽器開發者工具的 Console,看有沒有紅色的錯誤訊息。這一步的價值不只是「看到錯誤」,而是確認錯誤的確切位置與堆疊。很多時候一個語法錯誤會引發連鎖反應,真正的源頭在堆疊的最底層,而不是畫面上症狀最明顯的地方。
路徑寫錯、檔案沒上傳、CDN 載入失敗、版本衝突、函式名稱拼錯——這一類問題佔了實際排查中的相當大比例。在 Network 面板確認請求的狀態碼,在 Console 輸入函式名稱看是否為 undefined,都是幾秒鐘的事。
持續刪除不相關的程式碼,直到問題剛好消失的那一刻——此時你刪掉的那一段就是嫌疑犯。這個手法(有人稱之為「二分除錯」或「最小可重現範例」)幾乎總是有效,而且比盯著幾百行程式碼沉思有效率得多。它同時能幫你排除掉「我以為是這裡出問題」的錯覺。
無論是自己記錄、寫 issue 還是找人求助,好的描述應該包含:預期行為是什麼、實際行為是什麼、最小重現步驟、錯誤訊息原文、環境與版本。缺少哪一項,對方就得回問一次,來回一趟的時間成本遠高於一開始寫清楚。
工具換了,骨架不變。今天的對應做法是:
Sources 面板設中斷點逐步執行。npm ls 檢查相依樹。五步之中,第四步的效益最高也最常被跳過。多數人卡住時的反應是加更多 console.log,但真正該做的是刪東西——把問題逼到只剩必要的幾行,答案通常就自己浮現了。