本文示範如何把一個以 RequireJS 為基礎的專案做合併與壓縮。過程中會用到 Node.js,如果還沒安裝,建議先裝好再往下看。
RequireJS 讓你把程式碼切成許多小模組,開發時維護性極佳。但到了正式環境,把幾十個小檔案各自用一次 HTTP 請求抓回來,即使每個檔案都很小,往返時間加起來仍然可觀。解法是把這些腳本合併,用請求次數換載入時間。
另一個方向是縮小檔案體積。傳輸量小的檔案自然更快,這個過程稱為最小化(minification),做法是在不改變程式行為與功能的前提下改寫程式結構:移除多餘空白與註解、把區域變數與函式名稱縮短(mangling)等等。合併加上壓縮,合稱代碼優化。同樣的手法也適用在 CSS 上。
先回顧一下基礎:RequireJS 有 define() 與 require() 兩個主要方法,簽名幾乎相同,都知道如何處理依賴並在就緒後執行回呼。差別在於 define() 會把程式存成一個具名模組,因此它的回呼必須回傳一個值作為模組定義。這種模組就稱為 AMD(非同步模組定義)。
這裡用 Addy Osmani 的 TodoMVC 來示範,選用其中的 Backbone.js + RequireJS 版本。下載後解壓,把 todo-mvc 解壓目錄當成我們的根目錄(以下簡稱 <root>)。
打開 <root>/index.html,你會發現除了給 Internet Explorer 用的條件式註解之外,整份頁面只引用了一個腳本:
<script data-main="js/main" src="js/lib/require/require.js"></script> <!--[if IE]> <script src="js/lib/ie.js"></script> <![endif]-->
但如果開著開發者工具的 Network 面板執行,就會看到瀏覽器實際上抓了一整批 JavaScript 檔:

紅框內的檔案,都是 RequireJS 在執行期自動補抓的。
要優化這個專案,我們用 RequireJS Optimizer。從下載的檔案裡找到 r.js,複製到 <root> 目錄。r.js 是能執行 AMD 專案的命令列工具,其中更內含 Optimizer,可對腳本進行合併與壓縮。
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' }
}
})