为何从functions.php加载jQuery需二次刷新？WordPress适配求助

先看你代码里的一个致命拼写错误：注册jQuery的时候，handle写成了juery（少了字母q），而WordPress官方识别的jQuery handle是jquery。这个错误直接导致你的自定义脚本无法正确依赖jQuery——相当于你注册了一个完全不被系统认可的“假jQuery”，custom.js加载时根本找不到正确的jQuery对象，自然首次加载就失效，二次刷新靠缓存才勉强让进度条工作。

再加上你没给custom.js设置依赖关系，WordPress无法保证脚本加载顺序，就算jQuery能正常加载，也可能晚于custom.js执行，这也是功能不稳定的核心原因。

下面是修正后的完整代码，我会逐点解释修改逻辑：

function loadjs(){
    // 如果你确实需要替换WordPress自带的jQuery，务必保证handle是正确的'jquery'
    wp_deregister_script('jquery');
    wp_register_script('jquery', get_template_directory_uri() . '/assets/js/jquery-3.2.1.min.js', array(), '3.2.1', true);
    wp_enqueue_script('jquery');

    // 注册并加载custom.js，明确指定依赖为'jquery'，确保jQuery先加载完成
    wp_register_script('custom', get_template_directory_uri() . '/assets/js/custom.js', array('jquery'), false, true);
    wp_enqueue_script('custom');
}
add_action('wp_enqueue_scripts', 'loadjs');

关键修改点说明： #

1. 修正jQuery Handle拼写：把juery改成jquery，让WordPress能正确识别这个脚本，后续custom.js可以正常依赖它。
2. 添加脚本依赖与加载位置：
   • 给custom.js的第三个参数传入array('jquery')，告诉WordPress必须先加载完jQuery，再加载custom.js，彻底解决执行顺序问题。
   • 最后一个参数设为true，表示将脚本放在</body>标签前加载——这样脚本执行时，页面DOM已经渲染完成，不会出现找不到进度条、回到顶部按钮等DOM元素的情况。
3. 补充版本号参数：给jQuery添加版本号3.2.1，custom.js可以填false（或自定义版本号），用于缓存刷新，避免浏览器一直用旧脚本。

关于回到顶部功能仍失效的额外排查： #

如果修正代码后回到顶部还是没用，大概率是custom.js里的事件绑定逻辑有问题——比如脚本执行时，回到顶部按钮还没渲染出来，导致事件绑定失败。你可以把custom.js里的代码改成以下两种方式之一：

方式1：监听DOM加载完成后执行

// 用jQuery的ready方法确保DOM渲染完成后再绑定事件
jQuery(document).ready(function($){
    $('#back-to-top').click(function(){
        $('html, body').animate({scrollTop:0}, 500);
    });
});

方式2：使用事件委托（适合动态生成的元素）

如果回到顶部按钮是通过JS动态生成的，直接绑定事件会失效，改用事件委托：

jQuery(document).on('click', '#back-to-top', function(){
    $('html, body').animate({scrollTop:0}, 500);
});

额外建议： #

除非你有明确的版本需求，否则不建议随便注销WordPress自带的jQuery——很多插件会依赖官方版本，强行替换可能导致插件兼容问题。如果不需要替换，代码可以简化成这样：

function loadjs(){
    wp_enqueue_script('custom', get_template_directory_uri() . '/assets/js/custom.js', array('jquery'), false, true);
}
add_action('wp_enqueue_scripts', 'loadjs');

WordPress会自动加载自带的jQuery，并且确保在custom.js之前加载。

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