WordPress：仅在test页面加载custom_functions.php的代码不生效，求解决

你遇到的问题核心是页面匹配逻辑未生效或文件加载时机不对，以下是分步排查和修复方案：

1. 先验证页面匹配是否生效 #

很多时候问题出在is_page('test')没有正确匹配目标页面，先加调试代码确认（开启WP_DEBUG后查看wp-content/debug.log）：

function load_test() {
    // 调试：确认函数是否触发
    error_log('load_test 已执行');
    // 调试：确认是否匹配到test页面
    error_log('是否为test页面？' . (is_page('test') ? '是' : '否'));
    
    $file_path = get_stylesheet_directory() . '/class/custom_functions.php';
    if (is_page('test')) {
        if (file_exists($file_path)) {
            require $file_path;
            error_log('custom_functions.php 已加载');
        } else {
            error_log('文件不存在：' . $file_path);
        }
    }
}
add_action('wp', 'load_test');

如果日志显示“是否为test页面？否”，说明：

• 页面slug不是test（可能是test-page或其他），改用页面ID（比如is_page(123)，123为test页面的ID）或页面标题（is_page('测试页面')）
• 若为静态首页，is_page可能不生效，改用is_front_page()结合判断

2. 调整钩子时机（关键修复） #

如果页面匹配正常但函数仍不生效，说明加载文件的时机太晚：wp钩子虽在模板加载前，但如果custom_functions.php中的函数绑定了更早的钩子（比如init、wp_enqueue_scripts），这些钩子会在wp之前触发，导致函数未定义就被调用。

改用template_include钩子（模板加载前最后一个能正确判断页面的钩子）：

function load_test_functions($template) {
    $file_path = get_stylesheet_directory() . '/class/custom_functions.php';
    if (is_page('test') && file_exists($file_path)) {
        require $file_path;
    }
    return $template;
}
add_filter('template_include', 'load_test_functions');

该钩子会在WordPress确定模板文件后立即触发，此时加载自定义函数，模板或更早钩子中调用的函数都能正常生效。

3. 备选方案：函数级条件判断 #

如果不想调整钩子，可在custom_functions.php中给函数调用加条件判断，再全局加载文件（仅在test页面执行函数）：

// 定义函数
function test_page_function() {
    // 你的函数逻辑
}

// 只在test页面绑定钩子
if (is_page('test')) {
    add_action('wp_footer', 'test_page_function'); // 示例钩子，按需修改
}

这种方式全局加载文件也不会有性能问题，因为只有在test页面才会执行函数逻辑。

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