WordPress中is_front_page()限定函数仅首页生效失效原因

核心原因是WordPress条件判断标签is_front_page()的生效时机远晚于functions.php的加载时机，外层的条件判断从一开始就拿不到正确结果。
WordPress加载主题functions.php文件的节点在初始化流程的极早期，此时系统还没完成请求路由解析，也没有执行主查询，根本无法识别当前访问的页面是不是首页，这个阶段调用is_front_page()会固定返回false，直接导致if块内部的add_action钩子注册逻辑完全不会被执行，你写的回调函数自然永远不会触发。你最开始写的无判断版本能正常运行，是因为你无条件注册了init钩子，系统初始化到对应节点就会直接执行回调，和页面判断逻辑无关。

注意：

• 所有依赖主查询结果的is_*类条件标签（包括is_single()、is_page()、is_home()等），都必须等WordPress执行到wp钩子、完成主查询赋值之后才能返回正确结果，最早可在template_redirect阶段稳定使用，在这之前调用的返回结果都不可靠。
• 不要把函数定义写在if条件块里：PHP虽然语法上支持条件内定义函数，但如果站点其他代码在非首页场景调用了test()函数，会直接触发「函数未定义」的致命错误，函数定义始终要放在全局作用域下。

把条件判断挪到钩子回调函数内部，同时选择主查询已经完成的钩子挂载逻辑即可。如果你的逻辑是要在页面输出内容，推荐用template_redirect钩子挂载，示例代码如下：

add_action( 'template_redirect', 'test' );
function test() {
    if ( is_front_page() ) {
        echo 'Testing...123';
    }
}

如果你的逻辑不需要输出内容，只是做首页专属的初始化配置，也可以用wp钩子挂载，这个节点主查询刚执行完成，is_front_page()已经可以返回准确结果。

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