切换为主题自带child theme后站点多处异常，如何让其与parent theme表现一致？

我刚接手的站点使用第三方主题，此前有开发人员对其做了部分自定义修改。站点所有者要求升级主题，我完成新版主题安装后，除原有修改未按预期生效外，站点其余表现均正常。我计划创建子主题整合原有修改，而该主题本身自带子主题选项，我完成安装并激活后，站点多处功能失效：整个header样式错乱、内容缺失等。此时我尚未进行任何自定义修改，我原本认为空白（或接近空白）的子主题在我添加修改前不会改变站点原有表现，尤其是主题官方自带的子主题。

请问这类情况是否属于正常现象？是否有方法可以让子主题的表现与父主题完全一致？

1. 该现象是否属于正常情况 #

不属于预期内的正常现象，但属于WordPress第三方主题生态下非常普遍的问题，并非操作失误导致。
常见诱因如下：

• 主题官方自带的子主题并非完全空白，通常预置了自定义样式、功能代码甚至存在代码错误，激活后会直接覆盖父主题的对应逻辑
• 父主题未遵循WordPress官方子主题开发规范，存在硬编码资源路径、用子主题专属路径函数加载父主题资源的问题，激活子主题后路径识别失效，导致样式、脚本加载失败
• 此前开发人员直接修改了父主题的核心文件，子主题激活后不会继承父主题核心文件的自定义改动，这部分逻辑直接失效引发异常

2. 实现子主题与父主题表现完全一致的操作方案 #

第一步：清理子主题预置冗余代码 #

子主题仅需保留两个核心文件即可正常运行，删除其余所有预置文件，两个核心文件的代码规范如下：

• style.css 仅保留必填的主题声明注释，删除所有自定义样式：

/*
 Theme Name:   [你的父主题名称]子主题
 Template:     [父主题的目录名称，必须和父主题文件夹名完全一致]
 Version:      1.0.0
*/

• functions.php 仅保留标准的父/子主题样式入队代码，删除所有预置功能代码：

<?php
add_action( 'wp_enqueue_scripts', 'custom_child_enqueue_assets' );
function custom_child_enqueue_assets() {
    // 加载父主题样式
    wp_enqueue_style( 'parent-theme-style', get_template_directory_uri() . '/style.css' );
    // 加载子主题样式，依赖父主题样式，确保优先级正确
    wp_enqueue_style( 'child-theme-style', get_stylesheet_directory_uri() . '/style.css', array('parent-theme-style'), wp_get_theme()->get('Version') );
}
?>

第二步：迁移父主题的原有自定义修改 #

对比升级前旧版父主题和新版父主题的文件差异，把此前开发人员直接修改的父主题内容迁移到子主题中：

• 模板文件修改：在子主题中创建和父主题同名的模板文件，把修改后的代码复制到对应文件中，子主题模板会优先于父主题模板生效
• 功能逻辑修改：统一整理后放到子主题的functions.php文件末尾
• 样式修改：统一整理后放到子主题的style.css文件末尾

第三步：修复父主题路径兼容问题 #

如果上述操作完成后仍有异常，说明父主题本身存在路径兼容缺陷：

• 搜索父主题代码中所有使用get_stylesheet_directory()、get_stylesheet_directory_uri()的位置，这两个函数激活子主题时会返回子主题路径，如果父主题用其加载自身资源，就会出现404错误
• 把父主题中对应位置的函数替换为get_template_directory()、get_template_directory_uri()，或者在子主题的对应路径下补全缺失的资源文件即可

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