用途:在 WordPress 主题或插件目录内安全地开启、关闭调试模式,并分析错误日志。
主要能力:自动解析 WordPress 根路径,依次检查 ../../../wp-config.php、../../../../wp-config.php,必要时用 find / -maxdepth 5 -name wp-config.php -not -path '/vendor/' 2>/dev/null | head -5 查找并请用户确认;备份 wp-config.php 为 wp-config.php.pre-debug-backup;注释已有调试常量后插入调试块,启用 WP_DEBUG、WP_DEBUG_LOG、WP_DEBUG_DISPLAY=false、SCRIPT_DEBUG、SAVEQUERIES,并设置 display_errors=0;清空并 tail -f wp-content/debug.log;停止时从备份恢复并删除备份,保留 debug.log;可按类型分组分析日志并高亮当前主题/插件来源的错误。
使用方式:对助手说“start debugging”“debug WordPress”“enable debug mode”开启;说“stop debugging”“turn off debug”“disable debug mode”关闭;说“analyze the log”“check errors”分析日志。
限制:需可写 wp-config.php 与 wp-content 目录;WP_DEBUG_DISPLAY 为 false,错误不显示在浏览器;停止时不删除 debug.log;不要把启用调试的 wp-config.php 提交到版本控制。