JavaScript 中 Map 與 WeakMap 的區別、聯系及示例

---

核心區別

特性	Map	WeakMap
鍵的類型	允許任意類型的鍵（對象、原始值）	鍵必須是對象（非原始值）
垃圾回收	強引用鍵 → 阻止垃圾回收	弱引用鍵 → 不影響垃圾回收
可遍歷性	支持遍歷（keys(), values(), entries()）	不可遍歷（無遍歷方法）
Size 屬性	有 size 屬性獲取鍵值對數量	無 size 屬性
清除方法	有 clear() 方法	無 clear() 方法
性能	頻繁增刪時內存占用較高	內存優化（自動清理無引用鍵值對）

---

核心聯系

1. 鍵值對存儲
   二者均為鍵值對集合：set(key, value) / get(key) / has(key) / delete(key)
2. 鍵的唯一性
   鍵具有唯一性（引用不同的對象視為不同鍵）

---

代碼示例

1. Map 基本用法

const user = { id: 1 };
const settingsMap = new Map();// 添加任意類型鍵
settingsMap.set(user, { theme: "dark" });  // ? 對象鍵
settingsMap.set("language", "en");         // ? 字符串鍵console.log(settingsMap.size);           // 2
console.log(settingsMap.get(user));      // { theme: "dark" }// 遍歷Map
for (const [key, val] of settingsMap) {console.log(`${key}: ${JSON.stringify(val)}`);
}

2. WeakMap 基本用法

const user = { id: 1 };
const metadata = new WeakMap();metadata.set(user, { lastLogin: "2023-10-05" });  // ? 只允許對象鍵
// metadata.set("role", "admin");                 // ? TypeErrorconsole.log(metadata.has(user));     // true
console.log(metadata.get(user));     // { lastLogin: "2023-10-05" }// 當對象被銷毀時
user = null;  // 移除對user對象的引用// 垃圾回收后，WeakMap自動刪除對應鍵值對
// metadata.get(user) → undefined (無法直接驗證)

---

高級場景示例

場景 1：Map 的強引用問題

let data = { key: "value" };
const map = new Map();
map.set(data, 1);data = null;  // 移除引用// Map仍保留鍵值對 → 內存泄漏
console.log([...map.keys()]); // [{ key: "value" }] 

場景 2：WeakMap 解決內存泄漏

let data = { key: "value" };
const weakMap = new WeakMap();
weakMap.set(data, 1);data = null;  // 移除唯一引用// 垃圾回收后，weakMap自動清除鍵值對
// 無法直接檢查，但內存被釋放

場景 3：私有屬性模擬（WeakMap）

const privateStore = new WeakMap();class User {constructor(name) {// 每個實例關聯私有數據privateStore.set(this, { name });}getName() {return privateStore.get(this).name;}
}const alice = new User("Alice");
console.log(alice.getName());  // "Alice" // 外部無法訪問私有數據
console.log(alice.name);       // undefined

---

使用建議

場景	推薦	原因
需要遍歷鍵/值	Map	支持遍歷操作
存儲原始值作為鍵	Map	WeakMap 不支持原始值鍵
管理對象私有數據	WeakMap	避免內存泄漏，自動清理
臨時關聯對象與元數據	WeakMap	對象銷毀時自動解除關聯
緩存大量長期數據	Map	WeakMap 無大小控制和遍歷能力

核心總結：優先使用 Map 通用場景；選擇 WeakMap 需滿足 鍵是對象 + 需自動內存管理 兩大條件。