
启用调试模式需要编辑 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 安全、稳定并对开发者友好的最重要工具之一。