WordPress开启debug:开启开发者之眼
wordpress 开启debug

首页 2025-09-02 14:02:44

诸位少侠,江湖路远,代码如剑。老夫行走电商与开源二十载,深知“看得见的问题”永远好过“猜得着的毛病”。WordPress 这座江湖最大的城池,表面繁华,暗巷却常藏致命暗器。今日便与诸位论一论:如何亮出那柄名为 debug 的剑,把整座城池照得通明,让 bug 无处遁形。
第一式:心法——把 wp-config.php 当丹田
城池根目录下,有一卷《wp-config.php》,便是丹田所在。打开此卷,先寻得一行:
php
复制
define('WP_DEBUG', false);
此乃闭息之术,默认让城池风平浪静。欲开天眼,改为:
php
复制
define('WP_DEBUG', true);
仅此一步,城池便会在前端与后台同时吐出错误、警告、提示,如剑气外放,寸寸逼人。然,剑气过盛易伤己,需第二式护体。
第二式:护体——WP_DEBUG_LOG 与 WP_DEBUG_DISPLAY
剑气外放,若直接展示给百姓(访客),则人心惶惶。此时需:
php
复制
define('WP_DEBUG_LOG', true);   // 把剑气封进 /wp-content/debug.log
define('WP_DEBUG_DISPLAY', false); // 百姓界面不留痕
如此,错误尽入日志,百姓无感,开发者却可夜夜翻卷,逐条拆解。
第三式:藏剑——SCRIPT_DEBUG 与 SAVEQUERIES
若诸位还需雕琢前端 JS/CSS 或探查数据库慢剑,可再补两刀:
php
复制
define('SCRIPT_DEBUG', true);   // 让 WP 加载未压缩脚本,调试利器
define('SAVEQUERIES', true);    // 记录每条 SQL,配合 Query Monitor 更锋利
至此,城池灯火通明,暗器显形,少侠可安心夜读。
第四式:收剑——记得关闸
调试完毕,务必把上述开关复原,关闭 DEBUG_LOG 与 DEBUG,避免日志疯长、信息泄露。江湖规矩:出鞘之剑,必归鞘。
——以上为论剑,以下为实操——
教程:手把手开启 WordPress 的 DEBUG 模式
  1. 备份
    先备份 wp-config.php,防止手抖。
  2. 编辑文件
    用 FTP、SSH 或主机面板,找到站点根目录里的 wp-config.php,下载到本地。
  3. 插入三行
    /* That's all, stop editing! Happy publishing. * / 之前,加入:
    php
    复制
    // 开启调试
    define('WP_DEBUG', true);
    // 把错误写进日志,不显示给访客
    define('WP_DEBUG_LOG', true);
    define('WP_DEBUG_DISPLAY', false);
    // 如需调试脚本与 SQL,可再追加两行
    define('SCRIPT_DEBUG', true);
    define('SAVEQUERIES', true);
  4. 上传覆盖
    保存后上传覆盖原文件。
  5. 触发错误
    访问前台或后台,刻意制造错误(如调用不存在的函数),查看 /wp-content/debug.log 是否新增内容。
  6. 高级利器
    安装插件「Query Monitor」或「Debug Bar」,可在管理后台顶部工具条实时查看 SQL、钩子、PHP 错误,无需反复翻日志。
  7. 关闭调试
    问题解决后,把 WP_DEBUG 改回 false,把日志文件删除或清空,站点恢复清爽。
至此,诸位少侠已能挥剑如笔,洞察城池每一处暗伤。愿你们以 DEBUG 为镜,以代码为马,行稳致远。
MySQL连接就这么简单!本地远程、编程语言连接方法一网打尽
还在为MySQL日期计算头疼?这份加一天操作指南能解决90%问题
MySQL日志到底在哪里?Linux/Windows/macOS全平台查找方法在此
MySQL数据库管理工具全景评测:从Workbench到DBeaver的技术选型指南
MySQL密码忘了怎么办?这份重置指南能救急,Windows/Linux/Mac都适用
你的MySQL为什么经常卡死?可能是锁表在作怪!快速排查方法在此
MySQL单表卡爆怎么办?从策略到实战,一文掌握「分表」救命技巧
清空MySQL数据表千万别用错!DELETE和TRUNCATE这个区别可能导致重大事故
你的MySQL中文排序一团糟?记住这几点,轻松实现准确拼音排序!
别再混淆Hive和MySQL了!读懂它们的天壤之别,才算摸到大数据的门道