JavaScript 是弱型別語言,天生具備極大的靈活性——而靈活性的代價,就是團隊協作時容易失控。本文談談模塊化到底解決了什麼問題,並以一個 Leaflet 地圖繪圖工具的封裝實例,示範 RequireJS 的實際用法。
早期的做法是寫一個個 .js 檔,再用 script 標籤在頁面裡依序引入。專案小的時候沒問題,一旦規模上來就會同時爆發三個問題:
1. 全局變量氾濫。JavaScript 在任何地方都能宣告全局變量,一旦團隊成員各寫各的、沒有統一規範,全局命名空間很快就會塞滿雜物,甚至出現互相覆蓋的嚴重事故,後續維護成本極高。
2. 腳本載入順序被依賴關係綁死。最簡單的例子:a.js 依賴 b.js,那麼 b.js 就必須排在前面引入,否則直接報錯。當專案裡有幾十個檔案、彼此交叉依賴時,這個順序會變成一張無人能維護的迷宮。
3. 一次性載入過多腳本導致頁面假死。初始化時同步載入大量 JS,瀏覽器會忙著解析與執行而無法回應互動,使用者感受到的就是「卡住」。
RequireJS 的目標是鼓勵程式碼模塊化。它採用與傳統 script 標籤不同的腳本載入步驟:不再一次把全部檔案塞進頁面,而是宣告式地說明「這個模塊需要哪些依賴」,由 RequireJS 在執行時按需載入。
官方對它的定位說得很清楚:
RequireJS 的目標是鼓勵程式碼的模塊化,它使用了不同於傳統 script 標籤的腳本載入步驟。可以用它來加速、優化程式碼,但其主要目的還是為了程式碼的模塊化。它鼓勵在使用腳本時以 module ID 替代 URL 位址。
換句話說,加速只是附帶好處,用模塊 ID 取代 URL 依賴才是核心價值。關於安裝與設定(尤其是 require.config 裡的 paths 對應),建議直接參考官方文件,這裡不贅述。
我在專案中遇到一個很典型的情境:使用了輕量級開源地圖庫 Leaflet,但團隊裡不少成員並非 GIS 背景,直接面對 Leaflet 的原始 API 門檻偏高。於是在它之上再包一層,把介面換成更貼近領域語言的方法名,同時也讓分工變得清楚——每個人只要照 RequireJS 的規範寫好自己的模塊、預留好介面即可。
需求很單純:做一個繪圖輔助類,能畫點、線、面。
define(['leaflet'], function () {
/**
* 繪製多段線
*/
var _drawLine = function (latlngs, options) {
return L.polyline(latlngs, options);
};
/**
* 繪製多邊形
*/
var _drawPolygon = function (latlngs, options) {
if (latlngs.length < 3) {
console.log("點數少於 3,無法繪製多邊形!");
return;
}
// 若終點與起點相同,先移除,避免 Leaflet 多畫一層
var firstPt = latlngs[0];
var lastPt = latlngs[latlngs.length - 1];
if (firstPt.equals(lastPt)) {
latlngs.pop();
}
return L.polygon(latlngs, options);
};
/**
* 繪製矩形
*/
var _drawRect = function (bounds, options) {
return L.rectangle(bounds, options);
};
/**
* 繪製圓形
*/
var _drawCircle = function (center, radius, options) {
return L.circle(center, radius, options);
};
// 只暴露公共方法,其餘一律隱藏
return {
drawLine: _drawLine,
drawPolygon: _drawPolygon,
drawRect: _drawRect,
drawCircle: _drawCircle
};
});
這個結構有幾個刻意安排的細節。define() 的第一個參數宣告了依賴 leaflet,第二個參數的工廠函式會在依賴就緒後才執行,因此裡面可以安心使用全域的 L。所有實作函式都加上底線前綴表示「內部使用」,最後只回傳一個包含公共方法的物件——這正是上一篇文章談閉包時提到的「隱藏細節」在模塊層級的應用。
另外,_drawPolygon 裡順手處理了兩個實務上常遇到的問題:點數不足 3 無法構成多邊形,以及首尾點重複時要先移除,否則 Leaflet 會畫出多餘的線段。把這類防呆邏輯收進模塊,呼叫方就不必每個地方重寫一次。
require(['drawHelper'], function (drawHelper) {
function drawLine() {
var latlngs = [];
for (var i = 20; i < 30; i++) {
for (var j = 100; j < 110; j++) {
latlngs.push(new L.latLng(i, j));
}
}
var opt = { color: 'blue', weight: '2', opacity: 0.8, smoothFactor: 2.0 };
drawHelper.drawLine(latlngs, opt).addTo(mainmap);
}
function drawPolygon() {
var latlngs = [
L.latLng(31, 110), L.latLng(31, 111), L.latLng(32, 111),
L.latLng(32, 110), L.latLng(32, 109)
];
var opt = {
stroke: true, color: 'blue', weight: '2', opacity: 0.8,
fill: true, fillColor: 'red', fillOpacity: 0.6
};
drawHelper.drawPolygon(latlngs, opt).addTo(mainmap);
}
function drawRect() {
var bounds = [[33, 110], [36, 113]];
var opt = {
stroke: true, color: 'blue', weight: '2', opacity: 0.8,
fill: true, fillColor: 'yellow', fillOpacity: 0.6
};
drawHelper.drawRect(bounds, opt).addTo(mainmap);
}
function drawCircle() {
var center = L.latLng(32, 116);
var opt = {
stroke: true, color: 'red', weight: '2', opacity: 0.8,
fill: true, fillColor: 'green', fillOpacity: 0.6
};
drawHelper.drawCircle(center, 200000, opt).addTo(mainmap);
}
drawLine();
drawPolygon();
drawRect();
drawCircle();
});
呼叫端只依賴 drawHelper 這個模塊 ID,完全不需要知道 Leaflet 的檔案路徑,也不必關心它何時載入完成。

這裡的封裝還不算徹底,但已經足夠用。像基礎地圖操作、圖層控制這些,都可以另外寫一個 mapControl 模塊統一管理。
值得補充的是,RequireJS 屬於 AMD 規範的實作,如今新專案多半已改用 ES Module(import / export)搭配打包工具,語法更簡潔、靜態分析能力也更好。但 AMD 所建立的觀念——用依賴聲明取代全局命名空間、用模塊邊界隱藏實作細節、按需載入而非一次塞滿——完全沒有過時。理解它解決了什麼問題,比記住哪個函式庫的 API 重要得多。
以上就是關於 JavaScript 模塊化編程的探討,希望對大家的學習有所幫助。