// a.js
var user = 'Tom';
var config = { api: '/api' };
// b.js
var user = 'Jerry'; // 覆蓋 a.js 的 user!
var config = { debug: true }; // 覆蓋 config
// 災難發生...
// a.js
(function () {
var user = 'Tom'; // 私有,外部不可訪問
var config = { api: '/api' };
// 需暴露的 API 掛到全局唯一命名空間
window.MyApp = window.MyApp || {};
MyApp.config = config;
})();
// b.js
(function () {
var user = 'Jerry'; // 不衝突
window.MyApp = window.MyApp || {};
MyApp.util = { /* ... */ };
})();
var MYAPP = MYAPP || {};
MYAPP.namespace = function (ns) {
var parts = ns.split('.');
var parent = MYAPP;
for (var i = 0; i < parts.length; i++) {
parent[parts[i]] = parent[parts[i]] || {};
parent = parent[parts[i]];
}
return parent;
};
// 使用
MYAPP.namespace('modules.user');
MYAPP.modules.user.getName = function () { return 'Tom'; };
MYAPP.namespace('utils.date');
MYAPP.utils.date.format = function () { /* ... */ };
var UserModule = (function () {
// 私有狀態
var currentUser = null;
var listeners = [];
// 私有方法
function notify() {
listeners.forEach(function (fn) { fn(currentUser); });
}
// 公共 API
return {
login: function (name) {
currentUser = { name: name, time: Date.now() };
notify();
},
logout: function () {
currentUser = null;
notify();
},
onChange: function (fn) {
listeners.push(fn);
},
getCurrent: function () {
return currentUser;
}
};
})();
// 使用
UserModule.login('Tom');
UserModule.onChange(function (u) { console.log('用戶變更:', u); });
// CommonJS (Node.js / Webpack / Browserify)
var _ = require('lodash');
module.exports = function () { /* ... */ };
// AMD (RequireJS)
define(['jquery', 'lodash'], function ($, _) {
return function () { /* ... */ };
});
// UMD (通用)
;(function (root, factory) {
if (typeof define === 'function' && define.amd) define(factory);
else if (typeof module === 'object' && module.exports) module.exports = factory();
else root.MyLib = factory();
})(this, function () { return { /* ... */ }; });
// user.js
const API_URL = '/api'; // 模塊頂級作用域即私有,非掛載全局
let currentUser = null;
export function login(name) {
currentUser = { name, time: Date.now() };
return currentUser;
}
export function getCurrent() {
return currentUser;
}
// main.js
import { login, getCurrent } from './user.js';
login('Tom');
ESM 優勢:靜態結構、樹搖、異步加載、嚴格模式默認、瀏覽器原生支持 (type=module)、Node.js 完美互通。
| 維度 | 全局變量 | IIFE + 命名空間 | 揭示模塊 | UMD/CommonJS | ES Modules |
|---|---|---|---|---|---|
| 全局污染 | 極高 | 1 個對象 | 1 個對象 | 0 (構建時) | 0 (原生) |
| 私有狀態 | 無 | 閉包 | 閉包 | 閉包/模塊作用域 | 模塊作用域 |
| 依賴管理 | 手動 script 順序 | 手動 script 順序 | 手動 script 順序 | 聲明式 | 聲明式 (import/export) |
| 樹搖 | 無 | 無 | 無 | 支持 | 原生支持 |
| 瀏覽器直運行 | 是 | 是 | 是 | 需構建/RequireJS | 需 type=module 或構建 |
| 適用場景 | 極簡 Demo | 老項目、無構建 | 組件庫、jQuery 插件 | 構建工具項目 | 現代項目首選 |
window.APP = {}APP.utils = ...APP.xxx 為 import,最終移除全局掛載| 誤區 | 正確做法 |
|---|---|
var a = 1 在 IIFE 外部就是全局 | IIFE 內部 var 才是私有,外部 var 仍掛載 window |
| 命名空間對象層級越深越好 | 2-3 層即可,過深 APP.module.sub.util.fn 讀寫繁瑣 |
window.jQuery = $ 就是模塊化 | 只是將庫掛載全局,內部仍可能污染;需庫自身用 IIFE/UMD 封裝 |
| ESM 必須用構建工具 | 現代瀏覽器支持 <script type="module"> 直接運行 |
避免全局變量污染的核心是**作用域隔離**與**顯式依賴聲明**。從 IIFE + 命名空間,到揭示模塊,再到 CommonJS/AMD/UMD,最終到 ES Modules,每一步都在解決「誰依賴誰、誰暴露什麼、私有狀態在哪」的問題。現代項目**直接使用 ESM**,配合 Vite/Webpack 等構建工具,是性能、維護性、生態兼容性的最優解。老項目可按「建立命名空間 → 歸入現有代碼 → 引入構建 → 遷移 ESM」路徑平滑升級。