多個庫(jQuery、Prototype、MooTools、舊版插件)皆佔用全域變數 `$`,後載入者覆蓋先前者,導致先前庫失效。
// 內部簡化邏輯
jQuery.noConflict = function (deep) {
if (window.$ === jQuery) window.$ = _$; // _$ 為 jQuery 載入前的 $ 參考
if (deep && window.jQuery === jQuery) window.jQuery = _jQuery;
return jQuery;
};
var $j = jQuery.noConflict();
$j("div").hide(); // 用 $j
$("content").hide(); // $ 仍為其他庫
jQuery.noConflict();
jQuery(function ($) {
// 回調內 $ 綁定 jQuery
$("div").hide();
});
// 外部 $ 為其他庫
jQuery.noConflict();
(function ($) {
// 此作用域內 $ 專屬 jQuery
$.fn.myPlugin = function () { ... };
})(jQuery);
// 外部 $ 不受影響
❌ 若 jQuery 載入在最後,`$` 已被它佔用,`noConflict()` 才能歸還給先前的庫。
// webpack/rollup/vite 專案
import $ from "jquery"; // 區域變數 $,不汙染全域
import "some-old-plugin"; // 插件若寫 $.fn.xxx 會報錯
// 修正舊插件:在 entry 手動掛全域(僅限必要)
import $ from "jquery";
window.jQuery = window.$ = $;
import "legacy-plugin"; // 現在能找到 $
**模組化天然隔離作用域**,不再需要 `noConflict()`。舊插件若假設全域 `$`,只需在入口檔**一次性掛載**即可。
| 場景 | 方案 |
|---|---|
| 傳統多庫共存 | 正確順序載入 + `jQuery.noConflict()` + ready 回調/IIFE 接收 $ |
| 開發 jQuery 插件 | IIFE `(function($){...})(jQuery)` 封裝 |
| 現代打包專案 | ES Modules 匯入,入口檔統一掛載全域 $(若舊插件需求) |
| 新專案 | 避免多庫共存,優先原生/單一框架 |