WordPress主题的header.php文件中HTML代码无法渲染是什么原因

问题原因排查与解决方案 #

你遇到的自定义header、footer内容被替换的问题，90%以上的情况是主题未被WordPress正确识别并激活，其余多为缓存、插件冲突导致，可按以下步骤逐一排查：

• 第一步：确认你的自定义主题符合WordPress基础规范
  WordPress要求自定义主题必须放在wp-content/themes/目录下的独立文件夹中，且文件夹根目录必须包含style.css和index.php两个基础文件，其中style.css顶部需要添加标准主题标识注释，WordPress才会把它识别为合法主题：

  /*
  Theme Name: 你的自定义主题名称
  Version: 1.0
  Description: 自定义测试主题
  Author: 你的名称
  */
  

  配置完成后进入WordPress后台「外观-主题」，找到你做的主题点击激活即可，此前你看到的自动注入的网站标题、powered by WordPress片段都是WordPress默认自带主题的输出内容。
• 第二步：排查插件冲突
  如果你已经激活了自己的主题还是出现内容被替换的情况，暂时停用所有第三方插件，尤其是页面构建器、自定义头部/页脚类插件，之后强制刷新页面测试，如果内容恢复正常，逐一开启插件定位冲突的插件即可。
• 第三步：清理所有缓存
  如果修改后内容没有变化，先按Ctrl+F5强制刷新浏览器忽略本地缓存，如果你安装了WordPress缓存插件，进入插件设置清空全部缓存，服务器、CDN如果有缓存也一并清理后再测试。
• 第四步：确认文件路径正确
  确认你编辑的header.php、footer.php、index.php文件，确实存放在你已经激活的自定义主题的根目录下，避免误改其他主题的文件。

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