多個 JS 庫(jQuery、Prototype、KISSY 等)或多版本 jQuery 都佔用全局變量 $ 和 jQuery,後載入者覆蓋先載入者,導致先前代碼失效。
// 保存原始引用
var _jQuery = window.jQuery,
_$ = window.$;
jQuery.noConflict = function(deep) {
if (window.$ === jQuery) window.$ = _$; // 歸還 $
if (deep && window.jQuery === jQuery) window.jQuery = _jQuery; // 歸還 jQuery
return jQuery; // 返回當前實例,供局部使用
};
<script src="prototype.js"></script>
<script src="jquery.js"></script>
<script>
var $j = jQuery.noConflict(); // $ 歸還 Prototype,$j 持有 jQuery
$j(function($) { /* 此處 $ 安全指向 jQuery */ });
// 全局代碼用 $j 或 jQuery
</script>
<script src="jquery-1.4.2.min.js"></script>
<script>var jQ142 = jQuery.noConflict(true);</script> // 歸還 $ 和 jQuery
<script src="jquery-3.6.0.min.js"></script>
<script>var jQ360 = jQuery.noConflict(true);</script> // 歸還 $ 和 jQuery
<script>
// 使用特定版本
jQ142(function($) { $('.legacy').legacyPlugin(); });
jQ360(function($) { $('.modern').modernPlugin(); });
</script>
關鍵:每次載入後立即調用 noConflict(true) 並保存引用,後續代碼通過閉包傳入 $ 參數。
// 插件代碼
(function($) {
$.fn.myPlugin = function() { /* ... */ };
})(jQuery.noConflict(true)); // 即使外部無 $,內部也安全
import $ from 'jquery',每個模塊擁有獨立 $,天然隔離,無需 noConflict。new webpack.ProvidePlugin({ $: 'jquery', jQuery: 'jquery' })。resolve.alias: { 'jquery$': 'jquery-legacy' } 針對特定模塊指定版本。noConflict(true) 後繼續使用全局 $ 或 jQuery,它們已被歸還/清空。$ 給 jQuery,載入順序:其他庫 → jQuery → var $ = jQuery.noConflict();(不傳 true)。掌握 noConflict 精髓,輕松駕馭複雜的多庫共存環境,平滑遷移舊代碼庫。