WordPress代码调试：3种零门槛可直接落地的实操方法

1. 启用WP_DEBUG核心全局调试模式

这是WordPress官方推荐的基础调试方案，覆盖全站所有错误，支持本地/生产环境使用，操作仅需修改1个文件：

实操步骤

• 找到对应站点的根目录文件：本地环境是站点文件夹（如XAMPP的htdocs/your-site），生产环境是FTP工具的public_html目录；
• 打开根目录的wp-config.php文件，定位到含WP_DEBUG的代码段（约第80行，不同版本略有差异）；
• 将原有代码替换为以下内容：

``` define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); @ini_set('display_errors', 0); ```

• 保存文件，刷新站点即可触发调试：所有PHP错误、WordPress核心/主题/插件的日志会记录到/wp-content/debug.log文件，该文件不存在会自动生成；

核心注意事项：生产环境调试时，必须保持WP_DEBUG_DISPLAY为false，避免错误信息暴露给访客，破坏站点安全。

查看日志方式：用FTP工具下载debug.log，用文本编辑器打开即可看到错误详情（如致命错误、代码警告、通知等），直接对应修改问题代码。

2. 主题/插件单独调试模式

如需仅调试单个主题或插件，避免全局调试干扰其他代码，可使用此方案，无需修改全局配置：

实操步骤

• 找到目标主题的functions.php文件：路径为wp-content/themes/当前激活主题名/functions.php；若用子主题调试，务必修改子主题的functions.php，不要动父主题，否则更新会丢失代码；
• 在文件末尾添加对应调试代码：
  • 仅调试当前主题：

``` add_action('init', function() { error_reporting(E_ALL); ini_set('display_errors', 1); $debug_file = get_template_directory() . '/debug-theme.log'; ini_set('error_log', $debug_file); }); ```

• 仅调试指定插件（如插件目录为your-test-plugin）：

``` add_action('init', function() { if (strpos($_SERVER['REQUEST_URI'], 'your-test-plugin') !== false) { error_reporting(E_ALL); ini_set('display_errors', 1); $debug_file = WP_CONTENT_DIR . '/debug-plugin.log'; ini_set('error_log', $debug_file); } }); ```

• 保存文件，仅访问对应主题页面/插件链接时，错误会记录到独立日志文件，不影响其他页面。

3. WP_CLI命令行快速调试

适合有终端基础的用户，无需修改任何文件，通过命令行快速调试，生产环境也可安全使用：

安装WP_CLI（仅需1次）

• 本地Windows需先安装Git Bash/WSL，Linux/macOS直接执行以下命令：

``` curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar chmod +x wp-cli.phar sudo mv wp-cli.phar /usr/local/bin/wp ```

• 验证安装成功：执行wp --info，出现版本信息即可。

常用调试命令（站点根目录执行）

• 查看最近10条调试日志：wp debug show --limit=10；
• 清空调试日志：wp debug clean；
• 临时开启调试（仅当前1次请求）：wp debug enable --once；
• 关闭所有调试模式：wp debug disable；

关键细节：若站点不在当前终端路径，需加--path参数指定，如wp debug show --path=/var/www/html/your-site。

常见调试问题解决

问题1：debug.log无法生成

检查/wp-content目录的写入权限：Linux环境执行sudo chown -R www-data:www-data /你的站点路径/wp-content，Windows在FTP属性中勾选“写入权限”。

问题2：错误信息未显示

确认wp-config.php中WP_DEBUG_LOG为true，且PHP错误级别未被限制，生产环境请关闭display_errors，改用日志记录。

问题3：单独调试不生效

确认目标主题/插件处于激活状态，代码中的插件目录名需和实际目录完全一致，functions.php无语法错误（可在后台用插件如Code Sniffer检测）。

以上3种方案覆盖从基础到进阶的所有调试场景，无需额外工具，按步骤操作即可解决90%以上的WordPress代码问题，全程零门槛落地。