修改子主题single.php后网站异常，恢复原文件仍无法解决求助

1. 清除全链路缓存 #

• 关闭并清除WordPress缓存插件（如WP Rocket、W3 Total Cache）的缓存数据
• 用浏览器无痕模式访问网站，或手动清除浏览器缓存（快捷键Ctrl+Shift+Delete）
• 若使用CDN服务，同步清除CDN节点缓存

2. 校验子主题核心配置文件 #

检查子主题目录下的style.css头部信息，确保Template:字段与父主题文件夹名完全一致（区分大小写），示例格式如下：

/*
Theme Name: 自定义子主题
Description: 基于父主题的自定义子主题
Template: twentytwentyfour  // 此处必须是父主题的文件夹名
Version: 1.0.0
*/

如果该字段填写错误，子主题无法正确继承父主题的样式与模板逻辑。

3. 排查子主题冗余自定义文件 #

• 查看子主题目录下是否存在functions.php、header.php、footer.php等非必要自定义文件，若有则暂时重命名（如改为functions-old.php），之后刷新网站测试
• 确认重建子主题时，完全删除了旧子主题的所有文件，避免残留错误代码

4. 重置数据库模板缓存 #

WordPress会在数据库中存储模板缓存信息，可能残留异常数据：

• 登录phpMyAdmin，找到对应WordPress数据库
• 定位wp_options表（前缀可能因配置不同变化），查找template和stylesheet两个选项
• 确保template值为父主题文件夹名，stylesheet值为子主题文件夹名，若不符则手动修改并保存

5. 排查插件冲突 #

• 暂时禁用所有WordPress插件，切换回子主题测试是否恢复正常
• 若恢复正常，逐个重新启用插件，定位出导致冲突的插件，尝试更新插件或更换替代工具

6. 重置父主题文件 #

若以上步骤无效，可尝试重新覆盖父主题文件：

• 从WordPress官方主题库重新下载对应父主题
• 通过FTP将下载的父主题文件覆盖服务器上的父主题目录（操作前备份原父主题文件）
• 切换回子主题测试是否恢复正常

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