切换主题为何导致Twenty Seventeen子主题页面头部后空白？

这种切换主题后出现的头部后空白（含后台「外观」页）问题，我之前帮朋友排查过几次，大概率是子主题和父主题的加载逻辑冲突，或者切换过程中破坏了某些依赖，给你几个具体的排查和修复方向：

• 开启PHP错误日志定位问题：空白页90%以上是PHP致命错误导致的，WordPress默认会隐藏错误。你可以修改wp-config.php文件，开启调试模式：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false);
  

  访问空白页面后，去wp-content/debug.log文件里查看具体错误信息，比如是否有「函数未定义」「文件找不到」这类提示——这通常是子主题调用了父主题未正确加载的函数导致的。

• 检查子主题functions.php的钩子逻辑：子主题的functions.php里如果用了after_setup_theme、wp_enqueue_scripts这类钩子，要确认优先级是否合理，有没有在父主题完成初始化前就执行了依赖父主题的代码。比如子主题里直接调用父主题的自定义函数，但父主题的初始化钩子优先级比子主题低，就会导致函数未定义错误。

• 验证页面模板的路径与依赖：虽然你确认了页面选了正确的模板，但可以检查子主题模板文件（比如page-custom.php）里的代码：

  • 有没有硬编码的文件路径？比如用include('/wp-content/themes/twentyseventeen/xxx.php')，这种绝对路径在主题切换后可能失效，应该用get_template_directory()或者get_stylesheet_directory()来获取路径。
  • 调用模板部分时，是否用对了函数？比如get_template_part()会优先加载子主题的文件，没有再找父主题；如果是要强制加载父主题的模板，要用locate_template()配合load_template()。

• 排查后台专属代码的问题：后台「外观」页也空白，说明问题出现在后台加载流程中。检查子主题functions.php里有没有admin_init、admin_menu这类后台钩子的代码，比如是否尝试获取当前主题的某个自定义设置，但切换主题后这些设置被重置，导致代码报错。

• 清空所有缓存：主题切换后，服务器OPcache、WordPress插件缓存（比如缓存插件、页面生成缓存）可能保留了旧的代码缓存，导致加载异常。尝试清空所有缓存，包括服务器端的OPcache（如果有权限操作的话）。

• 确认子主题style.css的头部信息：检查子主题style.css开头的注释，确保Template字段正确指向父主题的文件夹名：

  /*
  Theme Name: Your Twenty Seventeen Child
  Template: twentyseventeen
  ... 其他信息 ...
  */
  

  这个字段如果写错，父主题不会被正确加载，切换主题后就会出现严重的依赖问题。

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