WordPress子主题Shortcode页面失效但文章正常问题求助

兄弟，这种子主题里短代码挂掉还带崩页面内容的情况我之前也踩过坑，结合你提到的修改记录（style.css、home.php、新增页面模板），咱们一步步来定位问题：

• 先盯紧你新建的页面模板
  这是最可疑的点——毕竟你是近期加了这个模板后出的问题。先检查模板里有没有正确调用the_content()：很多新手写自定义模板时，会图省事用echo get_post_field('post_content', get_the_ID());直接输出内容，但这个函数不会触发WordPress的短代码解析钩子，不仅短代码失效，要是模板里还有PHP语法错误（比如少了分号、括号不闭合），直接会导致页面中断加载，看起来就像所有内容都没了。
  另外，看看模板里有没有误加了remove_filter('the_content', 'do_shortcode');这种代码，直接把短代码解析给禁用了。

• 检查home.php的修改逻辑
  如果你在home.php里改动了主循环或者内容输出，重点看有没有碰过the_content的过滤链。比如有没有加过自定义过滤函数但忘了返回内容：

  add_filter('the_content', 'my_home_custom_content');
  function my_home_custom_content($content) {
      if (is_home()) {
          $content .= '<div>首页自定义模块</div>';
      }
      // 这里漏了return $content; 直接导致内容为空！
  }
  

  这种低级错误很容易犯，直接让页面内容消失，短代码自然也没法生效。

• 别漏了子主题的functions.php（哪怕你没主动改）
  有时候改模板时会顺手在functions.php加代码，比如自定义短代码或者修改内容过滤。检查：

  • 自定义短代码函数有没有语法错误（比如函数未闭合、变量未定义）；
  • 有没有和系统自带短代码slug冲突；
  • 有没有调整过do_shortcode的优先级，导致解析顺序出问题。
    另外，建议开启WP_DEBUG模式排查隐藏报错：在wp-config.php里添加这段代码：

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

  之后报错会写入wp-content/debug.log，能直接看到是不是PHP报错导致页面中断。

• 再确认CSS的间接影响
  虽然你说检查过CSS，但还是建议右键查看页面源码：如果源码里能看到内容，只是页面上看不到，那就是CSS的display: none或者visibility: hidden搞的鬼；如果源码里也没有内容，那肯定是PHP逻辑的问题，和CSS无关。

• 做隔离测试缩小范围

  • 把新建的页面模板重命名（比如改成page-template-old.php），然后把对应页面改回默认模板，测试短代码是否恢复正常；
  • 如果还是不行，把home.php替换成父主题的原版文件，再测试。
    这样一步步排除，很快就能定位到具体出问题的文件。

按这个思路排查下来，大概率能找到问题根源——子主题出这类问题，基本都是自定义模板、过滤函数的逻辑漏洞或者语法错误导致的。

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