开发首个WordPress插件遇激活错误及调试日志未生成问题求助

问题1：插件激活时出现意外输出提示 #

激活插件时收到提示：

The plugin generated 1 character of unexpected output during activation. If you notice “ headers already sent ” messages, problems with syndication feeds or other issues, try deactivating or removing this plugin.

用户已保留仅插件头部注释，检查过<?php前后无空格，尝试过添加/移除PHP闭合标签，问题仍存在。当前代码：

<?php
/**
* Plugin Name: 1jbtest
* Plugin URI: https://test.com/
* Description: JB  Experiment.
* Version: 0.1
* Author: JB
* Author URI: https://www.your-site.com/
* License: GPL2
**/

解决方案： #

• 检查文件编码：用VS Code、Notepad++等专业编辑器打开插件文件，将编码设置为UTF-8 无BOM格式后重新保存。UTF-8 BOM是隐藏的3字节字符，会被当作意外输出，这是此类问题的常见诱因。
• 严格控制文件开头：确保<?php是文件的第一个字符，前面没有任何空白、换行或不可见字符。
• 省略PHP闭合标签：WordPress官方推荐省略?>，避免标签后的空白字符被输出。

问题2：WP_DEBUG日志未生成 #

已在wp-config.php中启用DEBUG：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

但wp-content目录未生成debug.log，已检查权限仍无法解决。

解决方案： #

• 确认常量定义位置：必须将WP_DEBUG和WP_DEBUG_LOG的定义代码放在wp-config.php中/* That's all, stop editing! Happy publishing. */这一行之前，否则后续代码可能覆盖这些设置。
• 手动创建日志文件：在wp-content目录下手动创建debug.log文件，设置文件权限为666（或调整为服务器用户可写入的权限），再触发错误测试是否能写入。
• 排查冲突：暂时切换到WordPress默认主题（如Twenty Twenty-Four），禁用所有其他插件，测试日志是否生成，排除其他代码对DEBUG设置的干扰。
• 检查覆盖设置：确认wp-config.php中没有后续的define( 'WP_DEBUG_LOG', false );语句，也没有插件或主题通过代码修改了WP_DEBUG相关常量。

内容的提问来源于stack exchange，提问作者Jeff Baker