Web Analytics

如何在 WordPress 中启用调试模式

*我们挑选了我们认为您会喜欢的产品,并可能通过本页面的链接获得佣金。
WordPress 内置了调试模式,可帮助开发者和管理员检测主题、插件或核心系统中的问题。启用后,它会显示通常被隐藏的详细错误信息和警告。这让故障排查变得更加容易,并能确保快速找到问题的根源。

启用调试模式需要编辑 WordPress 安装中的一个文件。虽然操作简单,但必须小心进行,以免破坏网站。下面是逐步的正确操作指南。

启用后,你可以记录错误、将其隐藏不让访客看到,并控制 WordPress 如何处理调试信息。这在正式上线的网站上尤为重要,因为你希望记录错误,但不希望它们公开显示。


找到 wp-config.php 文件

启用调试模式的第一步是找到 wp-config.php 文件。该文件位于 WordPress 安装的根目录,与 wp-contentwp-includeswp-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 安全、稳定并对开发者友好的最重要工具之一。

Enable registration in settings - general