制作Twentyseventeen子主题时覆盖custom_header报错求助

嘿，我太懂这种明明按步骤来却报错的憋屈感了！针对Twentyseventeen子主题覆盖custom_header的问题，咱们一步步捋清楚问题出在哪，以及怎么解决：

很多新手会以为复刻父主题的目录结构就能自动替换文件，但inc目录下的功能文件（比如custom_header.php）不在WordPress默认的自动覆盖范围内！父主题的inc/custom-header.php是通过父主题functions.php里的代码主动引入的，子主题直接创建同名文件根本不会生效，反而可能因为加载顺序问题引发冲突。

1. 先处理函数与钩子的替换（推荐方式） #

Twentyseventeen的自定义头部功能是通过twentyseventeen_custom_header_setup函数挂在after_setup_theme钩子上的，我们不需要复刻整个文件，只需要在子主题里重写这个函数，然后替换掉父主题的钩子即可：

// 子主题的functions.php文件
// 第一步：重写自定义头部函数（函数名要和父主题的不一样，比如加个前缀）
function my_twentyseventeen_custom_header_setup() {
    // 这里复制父主题twentyseventeen_custom_header_setup函数里的代码，然后按需修改
    $args = array(
        'default-image'      => get_parent_theme_file_uri( '/assets/images/header.jpg' ),
        'default-text-color' => 'fff',
        'width'              => 2000,
        'height'             => 1200,
        'flex-height'        => true,
        'wp-head-callback'   => 'twentyseventeen_header_style',
        'admin-head-callback' => 'twentyseventeen_admin_header_style',
        'admin-preview-callback' => 'twentyseventeen_admin_header_image',
    );
    register_default_headers( array(
        'default-image' => array(
            'url'           => get_parent_theme_file_uri( '/assets/images/header.jpg' ),
            'thumbnail_url' => get_parent_theme_file_uri( '/assets/images/header-thumbnail.jpg' ),
            'description'   => __( 'Default Header Image', 'twentyseventeen' ),
        ),
    ) );
    add_theme_support( 'custom-header', $args );
}

// 第二步：替换父主题的钩子
// 优先级设为11，确保在父主题钩子（优先级10）之后执行，先移除再添加我们自己的
add_action( 'after_setup_theme', function() {
    remove_action( 'after_setup_theme', 'twentyseventeen_custom_header_setup' );
    add_action( 'after_setup_theme', 'my_twentyseventeen_custom_header_setup' );
}, 11 );

2. 如果一定要用子主题的inc/custom-header.php文件 #

如果你坚持把代码放在子主题的inc/custom-header.php里，那需要在子主题functions.php里主动引入它，同时确保替换父主题的钩子：

// 子主题functions.php
// 引入自己的custom-header文件
require get_stylesheet_directory() . '/inc/custom-header.php';

// 替换钩子，这里假设你在自己的custom-header.php里定义的函数是my_twentyseventeen_custom_header_setup
add_action( 'after_setup_theme', function() {
    remove_action( 'after_setup_theme', 'twentyseventeen_custom_header_setup' );
    add_action( 'after_setup_theme', 'my_twentyseventeen_custom_header_setup' );
}, 11 );

• 先看报错的具体内容：如果是「函数已声明」，说明父主题的函数还是被加载了，检查钩子替换的优先级是否正确；如果是「未定义函数」，说明你的自定义函数没被正确引入。
• 确认子主题已正确激活，父主题是原版Twentyseventeen（没被修改过的话，钩子逻辑才和上面一致）。
• 不要直接删除或修改父主题的文件，这会导致主题更新后丢失修改，也不符合子主题的最佳实践。

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