做 Web 開發,出錯是常態,真正決定效率的是「能不能快速定位問題出在哪一層」。與其漫無目的地亂改程式碼,不如先建立一張排查地圖:一個 B/S 架構的請求,從瀏覽器出發,經過網路傳輸,最後抵達伺服器,任何一環出問題,畫面上都會表現為「跑不出來」。
第一層:客戶端(瀏覽器)
這是最常見的一層,HTML、CSS、JavaScript 都在使用者電腦上執行。典型症狀包括版面跑掉、樣式沒套上、按鈕點了沒反應、控制台跳紅字。這一層的問題通常不需要後端配合,打開開發者工具就能看出端倪。
第二層:傳輸端(網路與資源)
這一層的問題最容易被誤判成程式錯誤,實際上多半是「檔案沒找到」或「檔案太大」:
- 路徑引用錯誤:常見外掛(artDialog、zTree、jQuery 等)、圖片、影片的相對路徑寫錯,或是部署到子目錄後路徑斷掉。
- 資源檔案過大:JS、CSS、圖片、影片體積過高,瀏覽器解析與下載時間被拉長,使用者感受到的就是「很慢」。此時該做的是壓縮與合併,而不是繼續加功能。
第三層:服務端
- 動態頁面的資料處理程式(資料存取層)出錯,例如查詢語法、連線設定、權限問題。
- 資料庫或檔案中的資料本身有問題,例如編碼不一致、欄位為空、格式與預期不同。
整體示意圖:

客戶端除錯的常用手法(F12 幾乎能解決大半問題)
- HTML/CSS 用元素面板直接檢查:點選箭頭選取元素,右側即可看到套用的樣式、繼承來源與被覆蓋的規則;JavaScript 則靠中斷點逐步執行,觀察變數與呼叫堆疊。
- 清除快取:舊的 JS、CSS 殘留在瀏覽器裡,是「改了卻沒生效」的頭號原因。除錯時養成硬重載或清快取的習慣。
- 用網路面板看請求與回應:表單傳值、AJAX 呼叫、狀態碼、回應內容、耗時分布,全部一目了然,能直接判斷問題在傳輸還是在業務邏輯。
- 清理 Cookie 與 Session:登入狀態、權限判斷異常時,先懷疑這裡。
別忽略瀏覽器的的文件模式(以 IE 為例)
IE 有兩種容易混淆的概念:
- 瀏覽器模式:決定使用哪一代的引擎與 User-Agent,例如 IE10 選擇「IE7 標準模式」,外掛判斷就會走另一條路。
- 文件模式:決定 HTML 實際被怎麼解析,可以手動指定:
<meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />
上面這行的作用是:不論 IE 版本為何,都用 IE7 引擎來解析頁面。當新版瀏覽器把舊頁面弄壞時,這類宣告是常見的過渡手段。

總結一句:除錯的第一步永遠是「先確認問題落在哪一層」,再選對工具。層級判斷對了,問題往往幾分鐘內就解決;判斷錯了,可能折騰一整天。以上是我在實務中累積的一些心得,若有不足之處也歡迎指教。