如何修复 WordPress 解析错误：完整指南
WordPress 解析错误是站长最常见、也最令人恐慌的错误之一。错误信息通常显示为 Parse error: syntax error, unexpected T_STRING in /path/to/file.php on line X，它能在瞬间让整个站点离线，连 wp-admin 后台也无法访问。
与白屏死机不同，解析错误的信息异常明确：PHP 因为无法理解代码而停止执行，并清楚地告诉你哪个文件、哪一行出了问题。本指南将解释该错误的含义、发生原因，以及如何逐步修复——无论是 functions.php 中缺少分号、插件中多余的括号，还是富文本编辑器引入的 BOM 字节顺序标记。
什么是 WordPress 解析错误？
解析错误（也称语法错误）发生在 PHP 引擎读取代码并发现无法解释为有效 PHP 内容时。由于 PHP 是即时编译的语言，解析器会在运行前先评估每个文件。一旦遇到意外的标记——未闭合的字符串、缺少分号、多余的括号——它会立即停止，拒绝执行文件的其余部分。
在 WordPress 中，这意味着 functions.php 或插件文件中的一行错误代码就能让整个站点瘫痪，因为该损坏文件会在正常加载流程中被引入。错误信息通常格式如下：
Parse error: syntax error, unexpected token "&" in /var/www/html/wp-content/themes/mytheme/functions.php on line 42行号通常精确到一两行之内，因此只要你能访问到该文件，定位问题就非常简单。
常见原因
解析错误几乎总在改动之后立即出现——一次编辑、一次更新或一次迁移。最常见的触发因素有：
- 缺少分号——PHP 语句必须以分号结尾，漏掉一个会让解析器把两条语句拼在一起。
- 未闭合的括号——缺少
)、]或}会让其后的所有内容进入错误的上下文。 - functions.php 中的 PHP 语法错误——被编辑最多的主题文件，也是解析错误最常见的来源。
- 插件代码错误——插件更新可能发布了有 bug 的代码，或复制粘贴到插件文件时引入了无效语法。
- BOM 编码——将 PHP 文件保存为带 BOM 的 UTF-8 会在开头插入不可见字节，PHP 会将其作为输出，破坏头信息和会话。
- PHP 版本不兼容——使用数组简写或可空类型的代码在 PHP 8.x 上能正常解析，但在 PHP 5.6 上会失败。
分步修复指南
第 1 步：读取完整错误信息
错误信息会指出确切的文件和行号。在做任何操作前，先把这两者记下来。如果错误显示被关闭、只看到白屏，就在 wp-config.php 中开启 WP_DEBUG 让信息显示出来。
第 2 步：通过 FTP/SFTP 访问文件
由于解析错误通常会把你锁在 wp-admin 之外，你一般需要使用 FTP/SFTP 或主机文件管理器。连接到服务器并导航到错误信息中显示的路径。
第 3 步：修复语法错误
用纯文本编辑器打开文件，跳转到报告的行号，修正语法。缺少分号、不匹配的引号或多余的括号是最常见的元凶。将文件保存为不带 BOM 的 UTF-8。
第 4 步：移除 BOM 编码
如果文件看起来正确但错误依旧，可能存在隐藏的 BOM 字节。将编码重新设置为 UTF-8（无 BOM） 保存，或在命令行中去除这些字节。
第 5 步：检查 PHP 版本兼容性
查看主机运行的 PHP 版本，并与主题或插件的要求对照。为 PHP 8.x 编写的代码可能使用了 PHP 5.6 不支持的语法，反之亦然。
第 6 步：重新启用组件并验证
修正文件后刷新站点。如果为了隔离问题而禁用过插件或切换过主题，就逐个重新启用，每次启用后刷新，这样再次出现问题时就能定位到单一组件。
PHP 诊断命令
在命令行下，你可以在不执行文件的情况下进行语法检查，搜索有问题的构造，并在不进入 wp-admin 的情况下管理插件：
# 对单个 PHP 文件进行语法检查
php -l wp-content/themes/mytheme/functions.php
# 检查当前主题中所有 PHP 文件
find wp-content/themes/mytheme -name "*.php" -exec php -l {} \;
# 搜索错误信息中报告的行号
grep -n "add_action" wp-content/themes/mytheme/functions.php// 在 wp-config.php 中临时开启调试输出
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', true);# 去除问题文件中的 UTF-8 BOM
sed -i '1s/^\xEF\xBB\xBF//' wp-content/themes/mytheme/functions.php
# 当 wp-admin 无法访问时，通过 WP-CLI 停用可疑插件
wp plugin deactivate suspect-plugin --path=/var/www/html
# 查看服务器运行的 PHP 版本
php -v快速参考表
| 现象 | 可能原因 | 修复方法 |
|---|---|---|
| unexpected '&' / T_STRING | 上一行缺少分号 | 补上分号，再用 php -l 检查 |
| unexpected end of file | 括号或圆括号未闭合 | 为每个 { 配上 } |
| unexpected '<' | PHP 代码块中出现原始 HTML | 关闭 PHP 标签或用 echo 输出 HTML |
| headers already sent | <?php 前有 BOM 或空白 |
重新保存为不带 BOM 的 UTF-8 |
| unexpected '?' | PHP 7.1 以下使用了可空类型 | 升级 PHP 或重写函数签名 |
| 插件更新后出现解析错误 | 更新发布了有问题的代码 | 回退插件或用 WP-CLI 停用 |
常见问题
为什么一次简单的编辑后就会出现解析错误？
几乎每个解析错误都发生在改动之后。哪怕只在 functions.php 中删除了一个分号或粘贴了一个不匹配的引号，都足以让 PHP 解析器停止。错误会立即出现，因为 WordPress 会在每次请求时重新读取该文件。
插件更新会导致解析错误吗？
会。插件作者可能发布了包含无效 PHP 的版本，更新时损坏的文件会覆盖正常工作的文件。请回退到上一版本，或通过 FTP（重命名其文件夹）或 WP-CLI 停用该插件，直到修复版本发布。
无法访问 wp-admin 时如何修复解析错误？
使用 FTP/SFTP 或主机的文件管理器。重命名问题插件文件夹以禁用它，或直接编辑主题文件。如果当前主题损坏，重命名其文件夹，让 WordPress 回退到默认主题，从而恢复 wp-admin 访问。
升级 PHP 能修复解析错误吗？
只有当错误源于版本不兼容时才行——例如在 PHP 5.3 上使用数组简写 []，或在 PHP 7.1 以下使用可空参数。如果原因是真正的拼写错误，升级 PHP 无济于事，必须从源头修正语法。
总结
WordPress 解析错误看似灾难性，但几乎总是一个字符的错误。读取信息中的文件和行号，通过 FTP/SFTP 打开文件，修正语法——一个分号、一个括号或一个 BOM。用 php -l 检查，确认 PHP 版本，再逐个重新启用组件。排查时保持 WP_DEBUG 开启，你的站点几分钟内就能恢复在线。