本文將演示如何對一個基於 RequireJS 的項目進行合並與壓縮。整個過程會用到若干工具,其中包括 Node.js,如果你還沒安裝,可以先下載一個。
動機
關於 RequireJS 已有不少介紹。這個工具能輕鬆地把 JavaScript 代碼拆分為多個模塊,讓代碼保持模塊化與易於維護。這樣一來,你會得到一組相互依賴的 JS 文件,而 HTML 中只需引用一個基於 RequireJS 的入口腳本,其餘文件便會被自動加載。
然而,在生產環境中把所有 JS 文件都拆開並不是好主意。文件過多會產生大量請求,即使每個文件都很小,累計起來也會浪費不少加載時間。合並這些腳本以減少請求次數,是節省加載時間的有效手段。
另一個思路是縮小文件體積——更小的文件傳輸更快。這個過程稱為最小化(minification),做法是小心地改變代碼結構而不改變其行為與功能,例如去除多餘空格、縮短變量名與函數名等。把合並與壓縮結合起來,就叫做代碼優化。這套方法不僅適用於 JS,也適用於 CSS。
RequireJS 有兩個主要方法:define() 和 require()。它們的聲明基本相同,都知道如何加載依賴並執行回調函數。與 require() 不同的是,define() 用來把代碼存儲為一個已命名的模塊,因此它的回調函數需要返回一個值作為模塊定義。這種被定義的模塊,就是所謂的 AMD(異步模塊定義)。
如果你對 RequireJS 還不太熟悉,也不必擔心,下面就用一個具體例子來說明。
JavaScript 應用的優化
本小節將以 Addy Osmani 的 TodoMVC Backbone.js + RequireJS 項目為例,展示優化過程。下載 1.1.0 版本並解壓,把 todo-mvc 目錄作為根目錄(下文記為 <root>)。
查看 <root>/index.html 的源碼,你會發現它只包含一個 script 標簽(另一個僅在 IE 下加載):
<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 標簽,就會發現浏覽器其實還加載了許多其他 JS 文件:

紅線框內的這些腳本,都是由 RequireJS 自動加載的。
接下來我們用 RequireJS Optimizer 來優化這個項目。找到 r.js 並複制到 <root> 目錄。jrburke 的 r.js 是一個能運行 AMD 項目的命令行工具,更重要的是它內置了 RequireJS Optimizer,能對腳本進行合並與壓縮。
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' } } })逐一講解所有配置項並非本文目的,這裡只說明所採用的關鍵參數。更多高級用法,可查閱官方文檔中所有可用配置選項的詳細說明。

有了構建文件後,進入 <root> 目錄並執行:
$ node r.js -o build.js
執行完成後會生成一個新文件夾 <root>/dist。此時 <root>/dist/js/main.js 已包含所有合並並壓縮後的依賴文件,<root>/dist/css/base.css 也被優化過了。
運行優化後的項目,外觀與優化前一模一樣。再看一下網絡傳輸,你會發現只加載了兩個 JS 文件:

RequireJS Optimizer 把服務器上的腳本從 13 個減少到 2 個,總大小也從 164KB 降到了 58.6KB(require.js 與 main.js)。
開銷
顯然,優化之後就再也沒有必要引用 require.js 了,因為已不存在被拆分的腳本文件,所有依賴也都已合並加載。
不過,優化過程把我們所有腳本合並成了一個文件,其中包含大量 define() 和 require() 調用。因此,為了讓應用正常運行,define() 和 require() 必須被定義並實施到應用的某處。
這就帶來一個眾所周知的開銷:我們總得打包一些實現 define() 和 require() 的代碼。這些代碼並不屬於應用本身,只是為了「基礎設施」而存在。開發 JavaScript 庫時,這個問題尤其突出——相比龐大的 RequireJS,庫本身通常很小,把它們綁在一起會造成可觀的開銷。
寫這篇文章時,這一開銷還沒有完美的解決方案,但我們可以用 almond 來緩解。Almond 是一個極簡的 AMD 加載器,實現了 RequireJS 的接口,可以在優化後的代碼中替代 RequireJS。如今我正致力於開發一個能無開銷優化 RequireJS 應用的優化器,但它仍處於早期階段,這裡暫不展示。
下載與總結
總的來說,通過合並與壓縮,RequireJS 項目能在不改變外觀的前提下大幅減少請求數量與加載體積,顯著提升生產環境下的加載性能。