WordPress 主题与插件的调试：开启 WP_DEBUG 之后要看什么

2026-10-20 · wordpress · 阅读 14

摘要

白屏排查的第一步永远是打开调试，但打开之后满屏提示，还得知道哪些是真正要处理的。wp-config.php 里的四项开关define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); defi

白屏排查的第一步永远是打开调试，但打开之后满屏提示，还得知道哪些是真正要处理的。

wp-config.php 里的四项开关

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
define('SCRIPT_DEBUG', true);

同时开启 LOG 和关闭 DISPLAY 是最实用的组合：错误写进 wp-content/debug.log，页面上不显示，避免访客看到路径信息。

很多人看到满屏 Deprecated 就慌了，其实那是主题在上个版本写的，只要没触发 Fatal 就不影响使用。

在 functions.php 顶部加一句：

if (!defined('WP_DEBUG')) { define('WP_DEBUG', true); }

这意味着交到客户手里之前一定要删掉，否则把错误显示开关带给了生产环境。

调试开启后会看到一条“已启用调试模式”，它本身不是错误，提醒你当前环境不适合对公网开放。

修完一批错误，记得加载 wp-content/debug.log 看一眼有没有新的报错累积。日志不会自动清空，文件会越来越大。

所属专题

标签

2026年10月20日 14:59 前后30天 · 点日期看归档

9月20日 9月21日 9月22日 9月23日 9月24日 9月25日 9月26日 9月27日 9月28日 9月29日 9月30日 10月1日 10月2日 10月3日 10月4日 10月5日 10月6日 10月7日 10月8日 10月9日 10月10日 10月11日 10月12日 10月13日 10月14日 10月15日 10月16日 10月17日 10月18日 10月19日 10月20日 10月21日 10月22日 10月23日 10月24日 10月25日 10月26日 10月27日 10月28日 10月29日 10月30日 10月31日 11月1日 11月2日 11月3日 11月4日 11月5日 11月6日 11月7日 11月8日 11月9日 11月10日 11月11日 11月12日 11月13日 11月14日 11月15日 11月16日 11月17日 11月18日 11月19日