WordPress插件开发：wp_enqueue_script通过add_action调用失效求助

直接调用wp_enqueue_script能正常加载JS，但封装成函数绑定wp_enqueue_scripts钩子就失效，可从以下几个方面排查解决：

1. 调整钩子优先级 #

wp_enqueue_scripts默认优先级为10，可能你的函数被其他插件/主题的脚本加载逻辑覆盖。尝试修改优先级，提前或延后执行：

// 提前执行（数字越小优先级越高）
add_action('wp_enqueue_scripts','my_custom_scripts', 1);

// 或者延后执行
add_action('wp_enqueue_scripts','my_custom_scripts', 99);

2. 修正文件路径计算 #

当函数定义在插件的子文件中时，__FILE__指向的是当前子文件而非插件主文件，导致路径计算错误。建议在插件主文件中定义全局路径常量：

// 插件主文件（比如my-plugin.php）中添加
define('MY_PLUGIN_DIR', plugin_dir_path(__FILE__));
define('MY_PLUGIN_URL', plugins_url('/', __FILE__));

然后在函数中使用常量：

function my_custom_scripts()
{ 
    $path = MY_PLUGIN_URL . 'js/main.js';
    $ver = filemtime(MY_PLUGIN_DIR . 'js/main.js');
    wp_enqueue_script( 'my-custom-plugin', $path, array(), $ver, true );
}
add_action('wp_enqueue_scripts','my_custom_scripts');

3. 排查函数是否被触发 #

在函数中添加调试日志，确认函数是否被执行：

function my_custom_scripts()
{ 
    // 查看WP调试日志是否有这条记录
    error_log('my_custom_scripts 已执行');
    $path = plugins_url('js/main.js',__FILE__);
    $ver = filemtime(plugin_dir_path(__FILE__).'js/main.js');
    wp_enqueue_script( 'my-custom-plugin', $path, array(), $ver, true );
}
add_action('wp_enqueue_scripts','my_custom_scripts');

如果日志中没有这条记录，说明add_action未被执行到——检查代码是否放在了错误的位置（比如未被加载的文件中），或插件是否正确激活。

4. 检查脚本Handle冲突 #

如果其他插件/主题使用了相同的脚本Handle（my-custom-plugin），会导致你的脚本被覆盖。尝试更换一个唯一的Handle名称：

wp_enqueue_script( 'my-unique-plugin-script', $path, array(), $ver, true );

5. 验证前端输出 #

查看页面源代码，搜索你的脚本Handle或JS文件名：

• 如果没有找到脚本标签：说明函数未执行或wp_enqueue_script调用失败
• 如果路径错误：回到第2步修正路径计算

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