WordPress插件内wp_enqueue注册的样式、脚本无法加载问题咨询

前置已确认条件 #

• 资源物理文件路径配置正确
• 当前主题已正确调用wp_head()、wp_footer()钩子

排查与解决步骤 #

1. 验证钩子是否实际触发 #

wp_enqueue_scripts仅在前台非管理端、非登录页、非AJAX/REST请求场景触发，若测试页面属于上述非触发场景，入队逻辑根本不会执行。

• 临时在wp_load_assets函数开头加入日志输出验证执行状态：

  function wp_load_assets() {
      error_log('wp_load_assets 执行触发，当前钩子上下文：' . current_filter());
      $plugin_url = plugin_dir_url( __FILE__ );
      wp_enqueue_style('tiny-slider-css', plugins_url( 'assets/css/tiny-slider.css', dirname( __FILE__ ) ), array(), '1.0', 'all');
      wp_enqueue_script('tiny-slider-js',  plugins_url( 'assets/js/tiny-slider.js', dirname( __FILE__ ) ), array(), null, true);
  }
  

• 查看wp-content/debug.log日志，若没有上述输出，说明钩子挂载失败，直接检查插件初始化逻辑。

2. 修正路径计算的层级偏差 #

原代码中plugins_url()搭配dirname( __FILE__ )的写法存在路径层级偏差：
插件主文件blog-category.php本身位于插件根目录，dirname(__FILE__)在主文件中返回的是插件的上级父目录，并非插件根目录，会导致拼接的资源路径指向错误位置。
统一基于主文件计算资源路径，修正后的代码为：

function wp_load_assets() {
    $plugin_root_url = plugin_dir_url( __FILE__ );
    wp_enqueue_style(
        'tiny-slider-css',
        $plugin_root_url . 'assets/css/tiny-slider.css',
        array(),
        '1.0',
        'all'
    );
    wp_enqueue_script(
        'tiny-slider-js',
        $plugin_root_url . 'assets/js/tiny-slider.js',
        array(),
        null,
        true
    );
}
add_action( 'wp_enqueue_scripts', 'wp_load_assets' );

3. 排查入队句柄冲突 #

你使用的入队句柄tiny-slider-css、tiny-slider-js是通用名称，极有可能被主题或其他插件提前注册，并设置了空路径或拦截加载。

• 临时加入入队状态验证代码：

  add_action('wp_head', function(){
      echo '<!-- 样式入队状态：' . (wp_style_is('tiny-slider-css', 'enqueued') ? '已注册' : '未注册') . ' -->';
      echo '<!-- 脚本入队状态：' . (wp_script_is('tiny-slider-js', 'enqueued') ? '已注册' : '未注册') . ' -->';
  });
  

• 查看页面源码的HTML注释，如果显示未注册，直接把入队句柄替换为带插件独有前缀的名称，比如blog-category-tiny-slider-css、blog-category-tiny-slider-js，避免和其他插件、主题的注册句柄冲突。

4. 检查插件加载上下文 #

• 确认插件在后台插件列表处于正常启用状态，没有因为PHP致命错误被自动停用。
• 确认入队代码没有被嵌套在永远不满足的条件判断内，比如错误判断当前页面类型导致函数永远不执行。

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