WordPress自带jQuery v3.6.0与自定义函数不兼容无法换版怎么解决？

核心根因 #

WordPress 自带的 jQuery 默认启用 noConflict() 模式，全局作用域下未绑定$别名，而你直接引用的Google CDN版jQuery默认暴露了$别名，这是绝大多数同类问题的诱因。

可落地解决步骤 #

• 优先检查浏览器控制台报错：按下F12切换到Console标签，分别访问两个测试页面，对比报错信息可直接定位出问题的代码行，效率远高于盲目排查。
• 适配noConflict模式：将你的自定义JS代码整体包裹在兼容闭包内，即可在代码内正常使用$别名，无需逐行替换：

(function($) {
  // 此处原有的所有自定义代码无需修改，可正常使用$
})(jQuery);

• 检查废弃API调用：jQuery 3.x移除了大量旧版本API，比如.live()、.die()、.toggle(多函数切换)等，即使引入jQuery Migrate也要确保是适配3.x的v3.x版本Migrate，若有废弃API调用，直接替换为新版等效方法即可：
  • 废弃的.live('click', function(){})替换为.on('click', function(){})
  • 废弃的.bind()替换为.on()，.unbind()替换为.off()
• 按WordPress规范加载脚本：不要直接在模板里硬写script标签引入脚本，在主题functions.php中用官方提供的加载函数挂载脚本，自动处理jQuery依赖和加载顺序：

function load_custom_art_module_script() {
    // 第三个参数array('jquery')声明脚本依赖jQuery，WordPress会自动前置加载自带jQuery
    wp_enqueue_script( 'custom-art-script', get_stylesheet_directory_uri() . '/js/你的自定义脚本文件名.js', array('jquery'), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'load_custom_art_module_script' );

• 可选方案：若确需使用Google CDN版jQuery，可在主题functions.php中注销默认jQuery后注册你需要的版本，注意可能和其他依赖自带jQuery的插件产生冲突，不推荐优先使用。

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