WordPress自定义主题single.php调用get_header失效问题求解

1. 重写固定链接规则 #

WordPress模板路由依赖rewrite规则，新增single.php后需要手动刷新规则：

• 进入后台 → 设置 → 固定链接
• 无需修改现有配置，直接点击「保存更改」，系统会自动重写路由规则

2. 修正静态资源引用路径 #

你当前header.php中使用的相对路径在单页场景下会解析错误，必须使用WordPress官方提供的动态路径函数调用资源：
原错误写法：

<link href="wp-content/themes/oxbir/css/bootstrap.min.css" rel="stylesheet">
<link href="wp-content/themes/oxbir/style.css" rel="stylesheet">

修改为正确写法：

<link href="<?php echo get_template_directory_uri(); ?>/css/bootstrap.min.css" rel="stylesheet">
<link href="<?php echo get_stylesheet_uri(); ?>" rel="stylesheet">

3. 补全footer.php文件 #

single.php末尾调用了get_footer()函数，如果主题根目录下未创建footer.php文件，会触发PHP致命错误导致页面加载中断。你可以选择两种方案修复：

• 在主题根目录新建footer.php文件，写入页面底部代码及</body></html>闭合标签
• 临时将single.php中的<?php get_footer(); ?>替换为以下代码：

</body>
</html>

4. 确认访问路径正确 #

WordPress主题模板文件不支持直接通过文件路径访问，必须通过WordPress路由访问文章详情页，不要直接输入single.php的文件地址访问。

5. 自定义文章类型适配 #

如果你访问的是自定义文章类型的详情页，默认single.php不会生效，需要将模板文件命名为single-{自定义文章类型别名}.php才会被系统识别加载。

6. 开启调试模式定位具体错误 #

如果以上操作都无法解决问题，开启WordPress调试模式查看具体报错：
找到站点根目录的wp-config.php文件，将调试参数修改为开启状态：

define( 'WP_DEBUG', true );

刷新异常页面就会显示具体的PHP报错信息，可根据报错快速定位问题。

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