jQuery.extend 是我們每天都在用卻很少細看的函式。讀一遍它的原始碼,不只學會怎麼正確合併物件,更能理解「淺拷貝」與「深拷貝」的實質差異,以及 JavaScript 高手是如何處理邊界條件的。
jQuery.extend = jQuery.fn.extend = function () {
var options, name, src, copy, copyIsArray, clone,
target = arguments[0] || {}, // 目標物件
i = 1,
length = arguments.length,
deep = false;
// 處理深度拷貝:第一個參數是 boolean 且為 true
if (typeof target === "boolean") {
deep = target;
target = arguments[1] || {};
i = 2; // 跳過前兩個參數
}
// 目標若不是物件或函式,就初始化為空物件
if (typeof target !== "object" && !jQuery.isFunction(target)) {
target = {};
}
// 只傳一個參數時,以 jQuery 自身為目標
if (length === i) {
target = this;
--i;
}
for (; i < length; i++) {
if ((options = arguments[i]) != null) { // 跳過 null/undefined
for (name in options) {
src = target[name];
copy = options[name];
if (target === copy) continue; // 防止無限迴圈
// 深度拷貝:遇到物件或陣列就遞迴
if (deep && copy &&
(jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)))) {
if (copyIsArray) {
copyIsArray = false;
clone = src && jQuery.isArray(src) ? src : [];
} else {
clone = src && jQuery.isPlainObject(src) ? src : {};
}
target[name] = jQuery.extend(deep, clone, copy); // 遞迴
} else if (copy !== undefined) {
target[name] = copy; // 不複製 undefined
}
}
}
}
return target;
};
如果一個物件中含有「參照型別」的成員(陣列或其他物件),淺拷貝只複製了那個「位址」,兩個物件會共用同一份內部的子物件;深拷貝則會把子物件的內容真正複製一份出來。

如上圖:兩個學生物件共用同一個「好友」物件,任一方修改好友資料,另一方立刻看得到。

而深拷貝之後:兩個學生各自擁有自己的好友物件,一方的修改對另一方完全透明。
if (length === i) { target = this; --i; }
對應原始碼中這段:只有一個參數時,target 被設為 this(也就是 jQuery 物件本身)。
var person = {
sex: 'male',
showName: function (name) { alert("Name: " + name); }
};
jQuery.extend(person); // 把 person 擴展到 jQuery($)
jQuery.showName("admin"); // Name: admin
alert("Sex: " + $.sex); // Sex: male
這正是 jQuery 外掛的標準寫法來源——$.fn.extend 擴展的是原型,因此所有 $() 產物都能使用;$.extend 擴展的是 jQuery 本身,成為靜態工具函式。
此形式為淺拷貝,實測:
var person = {
language: ['java', 'c++', 'sql'],
showName: function (name) { alert("Name: " + name); }
};
jQuery.extend(person);
$.language.push('PL/SQL'); // 修改擴展後的物件
alert(person.language); // java, c++, sql, PL/SQL ← 原物件也變了
person.language.pop();
alert($.language); // java, c++, sql ← 互相影響
任何一方對 language 陣列的修改都會影響另一方,這就是淺拷貝。
var person = { language: ['java', 'c++', 'sql'],
showName: function (n) { alert("Name: " + n); } };
var student = { showNum: function (n) { alert("Num: " + n); } };
jQuery.extend(student, person); // 把 person 合併進 student
student.showName("admin");
alert(student.language);
var person = { language: ['java', 'c++', 'sql'],
showName: function (n) { alert("Name: " + n); } };
jQuery.extend(true, person);
$.language.push('PL/SQL');
alert(person.language); // java, c++, sql ← 不再互相影響
var person = { showName: function (n) { alert("Name: " + n); } };
var student = { language: ["java", "c++", "javascript"],
showNum : function (n) { alert("Num: " + n); } };
// 淺拷貝
var target = jQuery.extend(person, student);
target.language.push("PL/SQL");
alert(student.language); // 含 PL/SQL,互相影響
// 深拷貝
var target2 = jQuery.extend(true, person, student);
target2.language.push("PL/SQL");
alert(student.language); // 不含 PL/SQL,互相獨立
target === copy 的循環參照防護。若物件參照到自己,沒有這行就會無限遞迴直到堆疊溢出。
copy !== undefined 的判斷。只跳過 undefined,但允許 null 被複製過去——這是刻意的設計,因為「明確設為 null」與「沒有設定」在語意上不同。
clone 的型別對齊。遞迴前先檢查目標既有值是不是陣列或純物件,是的話就沿用它(保留既有內容),不是才建立新的空陣列/空物件。這個細節讓「合併」而非「取代」成為可能。
jQuery.isPlainObject 而非 typeof。用來排除由其他建構子產生的物件(如 new Date())。這解釋了為什麼 extend 不會正確複製 Date 物件——它會被當成普通值直接指派位址。
// 淺合併
const merged = { ...target, ...source };
const merged = Object.assign(target, source);
// 深拷貝
const cloned = structuredClone(source); // 現代瀏覽器原生支援
// 注意:JSON 手法有陷阱
const bad = JSON.parse(JSON.stringify(obj));
// 會丟失 function、undefined、Date 變字串、Map/Set 變空物件
structuredClone 是目前的正確答案,它能處理 Date、Map、Set、迴圈參照,且不依賴第三方函式庫。理解 jQuery.extend 的實作,是為了看懂那些「為什麼我的物件合併後怪怪的」的歷史成因——尤其在維護仍使用舊版 jQuery 的專案時。