<script src="jquery-1.12.4.js"></script> <!-- 先載入舊版 -->
<script src="jquery-3.7.1.js"></script> <-- 後載入新版,佔據 $ 和 jQuery -->
<script>
// 釋放新版對 $ 和 jQuery 的佔用,歸還給舊版
var $jq3 = jQuery.noConflict(true); // true = 同時釋放 $ 和 jQuery
// 現在:$ 和 jQuery 指向 1.12.4,$jq3 指向 3.7.1
console.log($.fn.jquery); // "1.12.4"
console.log($jq3.fn.jquery); // "3.7.1"
</script>
<script src="legacy-plugins.js"></script> <-- 老插件使用 $ / jQuery (1.x) -->
<script src="new-module.js"></script> <-- 新模塊使用 $jq3 -->
// new-module.js 內部自包含
(function() {
// 1. 內聯 jQuery 3.x 源碼(壓縮版,約 90KB)
/*! jQuery v3.7.1 | (c) JS Foundation | jquery.org/license */
!function(e,t){"use strict";...}(this);
// 2. 立即釋放全局變量,獲得局部引用
var $ = jQuery.noConflict(true);
// 此處 $ 僅在這個 IIFE 作用域內可用,外部不可訪問
// 3. 編寫新功能代碼
$(function() {
// 使用 3.x 特性:Promise、on/off、CSS 變量等
$.ajax('/api/data').then(renderUI);
});
})();
// webpack.config.js
module.exports = {
resolve: {
alias: {
'jquery-legacy': 'jquery/dist/jquery.js', // 1.x
'jquery-modern': 'jquery/dist/jquery.slim.js' // 3.x slim
}
},
// 或使用 externals 讓舊版從全局獲取,新版打包進 bundle
externals: {
'jquery': 'jQuery' // 全局變量名
}
};
// 老模塊
import $ from 'jquery-legacy'; // 或 require('jquery-legacy')
// 新模塊
import $ from 'jquery-modern'; // 打包進 bundle,不佔用全局
$jq3,新代碼用 $jq3,舊代碼不動。$jq3 重命名為 $。noConflict 代碼,恢復標準 import $ from 'jquery'。| 問題 | 原因 | 解決 |
|---|---|---|
插件報錯 $.fn.xxx is not a function | 插件綁在錯誤版本的 $.fn 上 | 確保插件腳本在正確版本加載後執行 |
多個 noConflict() 混亂 | 順序錯誤導致變量指向錯誤 | 嚴格遵循:載入舊版 → 載入新版 → new版.noConflict(true) → 載入舊插件 → 載入新模塊 |
| 全局變量污染 | 未使用 IIFE 隔離新模塊 | 新模塊必須包裹在 (function(){ ... })() 中 |
document.querySelector、classList、dataset、Element.closest()fetch() + axios/kyWeb Animations API、motion-onelodash-es、原生 Array/Object 方法新項目強烈建議零 jQuery 起步,舊項目按上述策略漸進式去除。
jQuery.noConflict(true) 是多版本共存的核心鑰匙,關鍵在於加載順序與作用域隔離。最佳實踐是將新版 jQuery 內聯打包進新模塊文件,通過 IIFE 完全隔離,避免任何全局變量衝突。長期來看,以原生 API 或現代輕量庫替代 jQuery 是技術債務清理的必由之路。