
啟用除錯模式需要編輯 WordPress 安裝中的一個檔案。這很簡單,但必須小心進行,以避免網站損壞。以下將提供逐步的正確操作方法。
啟用後,你可以記錄錯誤、隱藏錯誤不讓訪客看到,並控制 WordPress 如何處理除錯資訊。這在正式上線的網站上尤其重要,因為你會希望錯誤被記錄下來,但不會公開顯示。
找到 wp-config.php 檔案
啟用除錯模式的第一步是找到 wp-config.php 檔案。此檔案位於 WordPress 安裝的根目錄,與 wp-content、wp-includes 和 wp-admin 位於同一層。你可以透過 FTP 軟體、主機控制台的檔案管理員,或在開發伺服器上以本機方式存取。
建議在進行修改前先備份此檔案。即使少了一個字元,也可能導致網站故障,而備份能確保你立即還原。找到檔案後,用文字編輯器打開並準備修改設定。
啟用 WP_DEBUG
在 wp-config.php 檔案內,向下捲動直到找到以下這行:define( 'WP_DEBUG', false );。這一行控制除錯模式是否啟用。WordPress 預設會停用除錯功能,以確保安全性與效能。要啟用它,只需將值從 false 改為 true。
正確的程式碼應該是:define( 'WP_DEBUG', true );。儲存檔案後,WordPress 會立即開始在整個網站上顯示 PHP 警告、通知與錯誤訊息。這有助於你找出有問題的外掛、主題或自訂程式碼。
使用 WP_DEBUG_LOG 紀錄錯誤
在螢幕上顯示錯誤對開發過程雖然有幫助,但並不總是實用。若要進行長期監控,你可以啟用 WP_DEBUG_LOG。方法是將以下程式碼加入 WP_DEBUG 常數之下:define( 'WP_DEBUG_LOG', true );。這會將所有錯誤儲存在 wp-content 目錄內的 debug.log 檔案中。
擁有紀錄檔特別有用,當你需要追蹤特定時間發生的錯誤,或無法在螢幕上直接重現時。它還能讓你在不提供網站直接存取權的情況下,將檔案分享給開發者或技術支援團隊。
隱藏訪客端的錯誤
如果你的 WordPress 網站已經上線,你大概不希望訪客看到原始的錯誤訊息。在這種情況下,可以新增另一個設定以停用前端的錯誤顯示:define( 'WP_DEBUG_DISPLAY', false );。這樣可確保錯誤依然被記錄,但不會顯示給使用者。
此外,你還可以加入 @ini_set( 'display_errors', 0 ); 來強化這個設定。這種組合能讓你的網站保持專業與安全,同時在除錯日誌中提供必要的資訊給管理員與開發者。
使用 SCRIPT_DEBUG 進行進階除錯
對於使用 JavaScript 和 CSS 的開發者,WordPress 提供了一個額外的常數:define( 'SCRIPT_DEBUG', true );。預設情況下,WordPress 會載入壓縮過的腳本與樣式。啟用腳本除錯後,WordPress 將強制載入完整且未壓縮的版本,方便檢查與除錯。
此設定在你開發主題或外掛,並需要追蹤腳本與樣式的行為時特別有價值。一般使用者通常不需要,但對於解決前端問題的開發者而言,會有很大幫助。
總結來說,在 WordPress 中啟用除錯模式是一個簡單卻強大的方法,可用於診斷與維護網站。透過編輯 wp-config.php 檔案,你可以顯示錯誤、將錯誤寫入日誌,並在出現問題時仍保持網站的專業外觀。若正確使用,除錯模式是讓 WordPress 保持安全、穩定且對開發者友善的最重要工具之一。