WordPress子主题functions.php函数无法在自定义模板调用求助

1. 检查子主题functions.php的语法错误 #

子主题的functions.php如果存在语法错误（比如漏写分号、括号不匹配、PHP版本不兼容的语法），会导致整个文件解析失败，函数根本不会被注册。

• 先把函数简化成最基础的测试版本：

  function blocksy_post_advocate_navigation() {
      echo '测试函数已执行';
  }
  

• 替换子主题functions.php里的对应代码，刷新页面看是否还报错。如果还是报错，说明functions.php本身没被正确加载。

2. 确认子主题是否激活 #

去WordPress后台「外观」→「主题」，检查当前激活的是不是Blocksy-child子主题。如果误激活了父主题，子主题的functions.php根本不会执行，自然找不到函数。

3. 验证模板文件的位置与命名 #

确保single-advocate.php放在子主题的根目录下，而不是某个子文件夹里。WordPress只会在主题根目录或指定模板路径下查找模板文件，位置不对的话会加载父主题的模板，而父主题里没有你定义的函数，就会报错。

4. 排查缓存干扰 #

缓存插件（如WP Rocket、LiteSpeed Cache）或服务器缓存可能会缓存旧的模板或PHP执行结果，导致子主题的修改没生效。

• 清空所有缓存：包括插件缓存、服务器缓存、浏览器缓存，然后重新访问页面测试。

5. 确认模板是否被正确加载 #

有时候自定义文章类型的模板会被插件或主题的模板重写功能干扰，导致实际加载的不是你子主题里的single-advocate.php。

• 在子主题的single-advocate.php开头添加测试代码：

  <?php die('当前加载的是子主题single-advocate.php'); ?>
  

• 访问自定义文章类型的单页，如果看不到这句话，说明加载的是其他模板，需要进一步排查模板加载优先级的问题。

6. 检查函数命名与作用域 #

虽然概率较低，但如果父主题或其他插件存在同名函数，可能会覆盖子主题的函数（不过子主题functions.php先加载，理论上子主题函数会优先，反过来如果父主题后加载同名函数会覆盖子主题的，但你这里是找不到函数，所以可能性低）。可以给函数加个专属前缀测试，比如改成my_blocksy_post_advocate_navigation，然后在模板里调用这个新函数。

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