無論簡單或複雜,Web 應用都由 HTML、JavaScript 與 CSS 組成。開發時我們常借助 jQuery、Knockout、Underscore 這類第三方框架來加速,因為它們針對特定用途打造且經過大量驗證,比自己從零實作划算得多。
但隨著應用複雜度上升,寫出乾淨、低耦合、可維護的程式碼就變得重要。本文說明 RequireJS 如何幫助你寫出模組化程式碼,並透過延遲載入提升效能。
下面的頁面有一個 id 為 message 的元素,用來顯示訂單編號與客戶姓名。Common.js 定義了 Order 與 Customer 兩個模組,並把 showData 綁到 body 的載入事件上;為了示範方便,資料直接寫死。
<!DOCTYPE html>
<html>
<head>
<title>不使用 RequireJS</title>
<script src="common.js" type="text/javascript"></script>
</head>
<body>
<strong>Display data without RequireJS</strong>
<p id="message" />
<script type="text/javascript"> showData(); </script>
</body>
</html>
// common.js
function write(message) {
document.getElementById('message').innerHTML += message + '</br>';
}
function showData() {
var o = new Order(1, "Prasad");
write("訂單編號:" + o.id + " 客戶姓名:" + o.customer.name);
}
function Customer(name) { this.name = name; return this; }
function Order(id, customerName) {
this.id = id;
this.customer = new Customer(customerName);
return this;
}

它能跑,但結構有毛病:
職責混在一起。common.js 裡同時塞了工具函式(write、showData)與領域模組(Order、Customer),難以維護與重用。若你只想在別的頁面用 write,卻得連不需要的模組一起載入。
模組之間硬綁。Order 在建立時直接 new 了一個 Customer,形成編譯期的強依賴,日後要替換或重構都很痛苦。
載入了用不到的資源。每次請求這個頁面,整份 common.js 都會進記憶體,即使這一頁只需要顯示一段文字。載入不必要的 JavaScript、CSS、圖片,都會拖慢效能。
依賴順序靠人肉維護。就算把模組拆到不同檔案,當應用變大,誰依賴誰、誰該先載入,很快就只能靠註解與默契維持。
重構後的 HTML 只引用 RequireJS,並用 data-main 指定唯一入口:
<script src="Require.Js" type="text/javascript" data-main="Main.js"></script>
Main.js 會被盡快載入,裡頭用 RequireJS 的函式宣告它對其他檔案的依賴:
// Main.js
require(["Order"], function (Order) {
var o = new Order(1, "Prasad");
write(o.id + o.customer.name);
});
第一個參數是依賴清單(這裡需要 Order.js),第二個參數是回呼函式。RequireJS 會分析所有依賴、依序載入,然後才執行回呼。要注意第一個參數用的名稱必須與檔名一致。
Order.js 用 define 宣告它需要 Customer:
// Order.js
define(["Customer"], function (Customer) {
function Order(id, custName) {
this.id = id;
this.customer = new Customer(custName);
}
return Order;
});
Customer.js 不依賴任何人,因此依賴陣列是空的:
// Customer.js
define([], function () {
function Customer(name) { this.name = name; }
return Customer;
});

用瀏覽器打開,輸出與先前相同,但這次 RequireJS 只載入了真正需要的檔案。
RequireJS 幫你處理 JavaScript 檔案之間的依賴關係,並依需要按順序載入。它帶來的不只是效能,更是一種結構約束:一旦依賴必須被顯式宣告,你就很難再寫出「什麼都塞在一個檔案裡」的程式。這份約束,正是可維護性的起點。