WordPress主题中嵌套PHP Include文件内容不显示求助

这个问题大概率是文件路径解析逻辑变化导致的——静态HTML环境下，PHP的include是相对于当前被包含文件的路径，但WordPress的执行上下文是从入口脚本（比如index.php）启动的，嵌套的include会以WordPress根目录或当前执行的主脚本为基准，而非你写的header.php所在路径。

具体修复方法 #

1. 使用WordPress主题目录常量（推荐）

WordPress提供了专门的函数来获取主题的绝对路径，彻底避免相对路径的混乱：

• get_template_directory()：返回父主题的绝对路径（适合父主题开发场景）
• get_stylesheet_directory()：返回当前激活主题（子主题）的绝对路径（适合子主题开发场景）

把你嵌套的include语句改成绝对路径形式，比如：

<?php include(get_template_directory() . '/includes/content/nav/top-nav.php'); ?>
<?php include(get_template_directory() . '/includes/content/rating-box.php'); ?>
<?php include(get_template_directory() . '/includes/content/booking/main-booker.php'); ?>

2. 用WordPress官方推荐的get_template_part()函数

这是主题开发中更规范的做法，它不仅自动处理路径，还支持子主题覆盖模板文件：

<?php get_template_part('includes/content/nav/top-nav'); ?>
<?php get_template_part('includes/content/rating-box'); ?>
<?php get_template_part('includes/content/booking/main-booker'); ?>

注意：get_template_part()不需要写.php后缀，它会自动补全文件扩展名。

3. 排查文件权限

如果路径设置正确仍无法显示，检查嵌套的PHP文件和includes目录的权限：

• 文件权限设置为644
• 目录权限设置为755
  确保Web服务器（比如Apache/Nginx）拥有读取这些文件的权限。

4. 开启调试模式定位问题

在wp-config.php中开启调试，查看具体错误信息：

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

如果存在文件找不到的错误，调试信息会直接显示出来，帮你快速定位路径问题。

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