jQuery、Prototype、MooTools 等早期庫都佔用 $ 作為核心別名。引入順序決定最終歸屬:
<script src="prototype.js"></script> // $ = Prototype
<script src="jquery.js"></script> // $ = jQuery (覆蓋 Prototype)
<script> $() </script> // 此處 $ 是 jQuery,Prototype 失去 $ 別名
<script src="prototype.js"></script>
<script src="jquery.js"></script>
<script>
// 1. 歸還 $ 給 Prototype
$.noConflict();
// 2. 在 IIFE 中用 $ 代表 jQuery
(function($) {
$(function() {
// 這裡 $ 確定是 jQuery
$('.my-class').hide();
$('#my-id').fadeIn();
});
})(jQuery);
// 3. 外部代碼 $ 是 Prototype
$('some-id').hide(); // Prototype 寫法
</script>
適用場景:遷移期項目、第三方插件依賴 $、團隊習慣用 $。
<script src="jquery.js"></script>
<script src="prototype.js"></script>
<script>
// 1. 獲取 jQuery 實例並自定義別名
var $j = $.noConflict(); // 或 var jq = $.noConflict();
// 2. 全局使用 $j 代表 jQuery
$j('.my-class').hide();
$j('#my-id').fadeIn();
// 3. $ 歸 Prototype 所有
$('some-id').hide();
</script>
適用場景:明確區分庫邊界、代碼審計清晰、避免 IIFE 包裹層層嵌套。
<script src="jquery-1.12.4.js"></script>
<script> var $jq112 = $.noConflict(true); </script> // true = 同時釋放 jQuery 變量
<script src="jquery-3.7.1.js"></script>
<script> var $jq371 = $.noConflict(true); </script>
// 使用特定版本
$jq112('.old-plugin').legacyPlugin();
$jq371('.new-component').modernPlugin();
極少見但救命場景:老插件強依賴 jQuery 1.x 新業務用 3.x,無法升級插件時的過渡方案。
// main.js 入口
import $ from 'jquery';
window.$ = window.jQuery = $; // 掛載全局(可選,供非模塊化代碼/插件使用)
// 插件自動識別模塊系統
import 'jquery-plugin-x'; // 內部通常用 factory((global.jQuery || $))
// 無需 noConflict!模塊作用域天然隔離
require.config({
paths: { jquery: 'libs/jquery-3.7.1' },
shim: {
'jquery-plugin': { deps: ['jquery'] }
}
});
define(['jquery', 'jquery-plugin'], function($) {
// 模塊內 $ 專屬,無衝突
$('.element').pluginMethod();
});
必須在載入 jQuery 之後、載入其他佔用 $ 的庫之前調用
$.noConflict()
<!-- ✅ 正確順序 -->
<script src="jquery.js"></script>
<script> $.noConflict(); </script>
<script src="prototype.js"></script>
<!-- ❌ 錯誤順序:Prototype 已佔用 $,noConflict 來不及救 -->
<script src="prototype.js"></script>
<script src="jquery.js"></script>
<script> $.noConflict(); </script> // 此時 $ 已是 Prototype,jQuery 丟失
| 坑點 | 現象 | 解決 |
|---|---|---|
| 插件內部用 $ 但未傳入 | 插件報錯 $ 未定義 | 插件應用 (function($){...})(jQuery) 模式;或全局掛載 window.$ = jQuery |
| noConflict(true) 導致 jQuery 變量丟失 | 後續 $.fn 擴展失效 | 僅在多版本共存時用 true,單版本用無參 noConflict() |
| IIFE 內未傳入 jQuery | 閉包內 $ 仍是外部庫 | (function($){ ... })(jQuery); 必須傳入 |
| 非模塊化腳本依賴全局 $ | 引入順序極其敏感 | 統一在入口文件 window.$ = window.jQuery = $ 後再載入腳本 |
$.noConflict() 是 jQuery 為多庫共存提供的「和平協議」:
$,保留 jQuery 變量,配合 IIFE 內部用 $true:同時釋放 $ 和 jQuery,需自定義別名保存實例(多版本共存)理解「全局命名空間汙染」與「模塊作用域隔離」的本質區別,才能在遺留項目遷移、微前端集成、第三方 SDK 接入等複雜場景中游刃有餘。