jQuery、Prototype、MoTools 等早期庫均佔用全局變量 `$`。當多庫共存時,後載入的庫會覆蓋先前的 `$`,導致代碼報錯。
| 方案 | 代碼模式 | 作用範圍 | 優點 | 缺點 |
|---|---|---|---|---|
| 1. 全局重命名 | var $j = jQuery.noConflict(); | 全局 | 徹底解決衝突 | 所有代碼必須改用 `$j`,第三方插件需修改,維護成本極高 |
| 2. ready 回調參數 | jQuery(document).ready(function($){ ... }); | ready 回調內部 | 無需改動現有 `$` 代碼 | 外部函數、插件、非 ready 代碼無效 |
| 3. IIFE 封裝(推薦) | (function($){ ... })(jQuery); | 函數作用域內 | 不污染全局、不影響其他代碼、插件開發首選 | 需手動包裹每個文件/模塊 |
;(function ($, window, document, undefined) {
'use strict';
// 內部 $ 安全指向 jQuery
// 這裡編寫所有插件代碼
$.fn.myPlugin = function (options) {
const opts = $.extend({}, $.fn.myPlugin.defaults, options);
return this.each(function () {
const $el = $(this);
// 插件邏輯
});
};
$.fn.myPlugin.defaults = {
color: 'blue'
};
// 暴露給全局(可選)
window.myPlugin = $.fn.myPlugin;
})(jQuery, window, document);
<script src="jquery-1.12.4.min.js"></script>
<script>
var jQuery112 = jQuery.noConflict(true); // true = 同時釋放 jQuery 變量
</script>
<script src="jquery-3.7.1.min.js"></script>
<script>
// 此處 $ 和 jQuery 指向 3.7.1
// jQuery112 指向 1.12.4
// 老插件使用
jQuery112.fn.oldPlugin = function() { ... };
// 新代碼使用
$(function() { ... });
</script>
**ES Modules 原生解決命名衝突**,無需 `noConflict()`:
// main.js
import $ from 'jquery'; // 模組作用域私有 $
import _ from 'lodash'; // 無衝突
// plugin.js
import $ from 'jquery'; // 同一實例(單例)
$.fn.myPlugin = function() { ... };
// 若需不同版本
import $ from 'jquery';
import jQueryLegacy from 'jquery-legacy'; // 別名導入
`jQuery.noConflict()` 是解決歷史遺留問題的權宜之計。**現代前端工程化下,模組系統才是根治命名衝突的正道**。若維護老代碼,請堅持使用 IIFE 封裝模式,將 `$` 限制在模塊作用域內,保護全局命名空間純淨。