
本文详解在 wordpress 自定义主题中安全、规范地引入 js 文件的方法,涵盖钩子使用、依赖声明、路径验证及常见错误(如 jquery 未定义)的排查与修复。
在 WordPress 主题开发中,绝不能直接在 HTML 中用 ,而应始终通过 wp_enqueue_scripts 钩子配合 wp_register_script() 和 wp_enqueue_script() 来加载脚本——这是确保兼容性、避免重复加载、正确处理依赖(如 jQuery)的唯一推荐方式。
你提供的代码逻辑基本正确,但存在多个关键问题导致脚本未生效或报错:
✅ 正确写法(已修正)
function mytheme_enqueue_scripts() {
// 1. 先确保 jQuery 已正确加载(WordPress 默认已注册,无需重复注册)
wp_enqueue_script('jquery');
// 2. 注册并加载 bootstrap.bundle.min.js,显式声明依赖 'jquery'
wp_register_script(
'mytheme-bootstrap-bundle',
get_template_directory_uri() . '/js/bootstrap.bundle.min.js',
array('jquery'), // 依赖数组:表示此脚本必须在 jQuery 之后执行
'5.3.3', // 版本号(建议用实际版本,便于缓存控制)
true // $in_footer = true → 输出到










