WordPress未执行wp_head()，样式无法加载问题求助

核心检查项 #

• 钩子优先级问题：wp_enqueue_scripts默认优先级为10，若注册时指定了大于10的优先级，可能在wp_head执行后才触发。检查代码优先级设置：

  // 错误示例：优先级过高可能导致执行滞后
  add_action('wp_enqueue_scripts', 'my_enqueue_styles', 20);
  // 推荐写法：使用默认或更低优先级
  add_action('wp_enqueue_scripts', 'my_enqueue_styles', 10);
  

• 样式入队完整性：确保完成完整的注册/入队流程，直接使用wp_enqueue_style会自动完成注册，示例：

  function my_enqueue_styles() {
      wp_enqueue_style(
          'custom-style',
          get_stylesheet_directory_uri() . '/css/custom.css',
          array(),
          '1.0.0',
          'all'
      );
  }
  add_action('wp_enqueue_scripts', 'my_enqueue_styles');
  

  注意路径正确性：子主题用get_stylesheet_directory_uri()，父主题用get_template_directory_uri()，路径错误会导致样式404，部分情况下Query Monitor可能不主动提示。
• wp_head调用位置：确认wp_head()放在</head>标签直接上方，未被条件判断包裹（如仅在特定页面加载）：

  <!-- 正确位置 -->
  <?php wp_head(); ?>
  </head>
  

进阶排查 #

• 缓存干扰：浏览器缓存或WordPress缓存插件可能保留旧页面状态，强制刷新页面（Ctrl+F5）或临时禁用缓存插件测试。
• 钩子是否被移除：检查主题/插件是否通过remove_action移除了你的钩子，可在函数内加调试输出验证执行情况：

  function my_enqueue_styles() {
      error_log('自定义样式入队函数已执行'); // 查看服务器错误日志确认
      wp_enqueue_style(...);
  }
  

  若日志无记录，说明钩子未触发。
• Query Monitor深度核查：在Query Monitor的「Enqueued Scripts & Styles」标签中搜索你的样式ID，确认是否存在。若未出现则钩子未执行；若存在但标记为“未加载”，检查依赖项是否缺失。

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