本文以 TodoMVC 的 Backbone.js + RequireJS 範例為素材,示範如何用 RequireJS Optimizer 把十幾個分散的腳本合併壓縮成兩個檔案。過程中會用到 Node.js,若尚未安裝可先行下載。
RequireJS 讓 JavaScript 程式碼得以拆分成多個模塊,保持結構清晰與易維護,並在 HTML 中只需引入一個進入點腳本,其餘檔案自動載入。
但在正式環境中把所有檔案保持分離並不明智。即使每個檔案都很小,大量的 HTTP 請求仍會累積可觀的等待時間。解法有兩個方向:
兩者合稱代碼優化,同樣的概念也適用於 CSS 檔案。
RequireJS 有兩個主要方法:define() 與 require()。兩者簽名相近,都知道如何載入依賴並執行回呼函式;差別在於 define() 會把程式碼存為一個具名模塊,因此其回呼函式需回傳值作為模塊定義。這類模塊統稱 AMD(Asynchronous Module Definition,異步模塊定義)。
下載 TodoMVC 1.1.0 版並解壓,取出 Backbone.js + RequireJS 目錄,本文以其為根目錄 <root>。
查看 <root>/index.html 會發現,除了針對 IE 的一行條件註解外,只有一個 script 標籤:
<script data-main="js/main" src="js/lib/require/require.js"></script>
<!--[if IE]>
<script src="js/lib/ie.js"></script>
<![endif]-->
整個專案只需要引用 require.js。但在瀏覽器中執行並打開開發工具的 Network 面板,會看到大量其他 JavaScript 檔被同步載入。

紅框內的檔案都是由 RequireJS 自動載入的。
從 RequireJS 官網下載壓縮檔,取出 r.js 並複製到 <root> 目錄。r.js 是命令列工具,能運行 AMD 專案,更重要的是內含 RequireJS Optimizer,可對腳本進行合併與壓縮。
它支援的範圍很廣:單一 JS 或 CSS 檔案、整個專案、專案的一部分,甚至多頁應用程式;壓縮引擎也可更換或完全不壓縮。本文只示範其中一種用法。
以 Node.js 運行:
$ node r.js -o <arguments>
參數有兩種傳遞方式。第一種直接寫在命令列:
$ node r.js -o baseUrl=. name=main out=main-built.js
第二種是建立設定檔(相對於執行目錄)並傳入檔名:
$ node r.js -o build.js
build.js 的內容:
({
baseUrl: ".",
name: "main",
out: "main-built.js"
})
設定檔的可讀性明顯更好,因此本文採用這種方式。為專案建立 <root>/build.js:
({
appDir: './',
baseUrl: './js',
dir: './dist',
modules: [
{ name: 'main' }
],
fileExclusionRegExp: /^(r|build)\.js$/,
optimizeCss: 'standard',
removeCombined: true,
paths: {
jquery: 'lib/jquery',
underscore: 'lib/underscore',
backbone: 'lib/backbone/backbone',
backboneLocalstorage: 'lib/backbone/backbone.localStorage',
text: 'lib/require/text'
},
shim: {
underscore: { exports: '_' },
backbone: {
deps: ['underscore', 'jquery'],
exports: 'Backbone'
},
backboneLocalstorage: {
deps: ['backbone'],
exports: 'Store'
}
}
})
其中幾個關鍵參數的作用:

appDir 指定專案根目錄,baseUrl 是模塊查找基準,dir 是輸出目錄;modules 列出要打包的進入點;paths 定義模塊名到實際路徑的映射;shim 則用來包裝不支援 AMD 的老舊函式庫,透過 exports 告訴 optimizer 該掛到哪個全域變數上。完整參數列表可查閱官方文件。
$ node r.js -o build.js
執行後會產生 <root>/dist 目錄。此時 <root>/dist/js/main.js 已包含所有合併並壓縮後的依賴檔案,<root>/dist/css/base.css 也一併被優化。
運行優化後的專案,畫面與優化前完全一致。但再看 Network 面板,會發現只載入了兩個 JavaScript 檔。

具體數據:腳本檔從 13 個降到 2 個,總大小從 164KB 降到 58.6KB(require.js 與 main.js)。
優化後已無需引用 require.js——所有檔案都被合併,不存在分離的依賴需要動態載入。
然而合併後的檔案中包含大量 define() 與 require() 呼叫,因此這兩個函式的實作仍必須存在於運行環境中。這構成一筆固定開銷:有一部分程式碼並非應用本身的邏輯,只是為了支撐模塊系統。開發大型函式庫時這點尤其明顯——庫本身很小,卻被迫背上整個載入器。
常見的緩解方案是 almond:一個極精簡的 AMD 載入器,實作了 RequireJS 的介面,可在優化後的程式碼中替換掉完整的 RequireJS。
整體流程可以濃縮為:安裝 Node.js → 取得 r.js → 撰寫 build.js 設定檔 → 執行 node r.js -o build.js → 部署 dist 目錄。把這套流程接入建置腳本,就能在每次發版時自動完成優化,不必再手動整理檔案。