開發階段模組分散利於維護,生產環境若仍發送數十個 HTTP 請求將嚴重拖慢首屏載入。本文以 TodoMVC Backbone+RequireJS 專案為例,完整演示 r.js 優化器的配置、執行、驗證與進階技巧。
<!-- index.html 僅載入 require.js -->
<script data-main="js/main" src="js/lib/require/require.js"></script>
瀏覽器 Network 面板顯示 20+ 個 JS 檔案並行請求,雖利用瀏覽器並行連線,但連線建立、TLS 握手、標頭開銷累積可觀。
define/require 依賴。@import、壓縮、內聯 url() 圖片。build.js({
// 專案根目錄
appDir: './',
// 模組基準路徑(相對 appDir)
baseUrl: './js',
// 輸出目錄
dir: './dist',
// 要優化的模組(入口)
modules: [
{ name: 'main' } // 對應 js/main.js
],
// 排除建構腳本自身
fileExclusionRegExp: /^(r|build)\.js$/,
// CSS 優化
optimizeCss: 'standard', // 'standard' | 'none' | 'standard.keepLines'
// 移除已合併的原始檔案(輸出目錄)
removeCombined: true,
// 路徑映射(同 require.config)
paths: {
'jquery': 'lib/jquery',
'underscore': 'lib/underscore',
'backbone': 'lib/backbone/backbone',
'backboneLocalstorage': 'lib/backbone/backbone.localStorage',
'text': 'lib/require/text'
},
// 非 AMD 模組包裝
shim: {
'underscore': { exports: '_' },
'backbone': {
deps: ['underscore', 'jquery'],
exports: 'Backbone'
},
'backboneLocalstorage': {
deps: ['backbone'],
exports: 'Store'
}
},
// 壓縮引擎選項
optimize: 'uglify2', // 'uglify2' | 'closure' | 'none'
uglify2: {
output: { beautify: false },
compress: { sequences: true, dead_code: true, drop_console: true },
warnings: false
}
})
# 安裝 Node.js 後
node r.js -o build.js
產出 ./dist 目錄,結構鏡像原專案,但 js/main.js 已包含所有依賴模組,css/base.css 已合併壓縮。
# 修改 index.html 指向優化後入口
<script data-main="js/main" src="js/lib/require/require.js"></script>
# (require.js 本身不納入合併,保持快取)
Network 面板:JS 請求從 20+ 降為 2 個(require.js + main.js),體積壓縮 70%+,首屏載入時間顯著下降。
modules: [
{ name: 'page/home' },
{ name: 'page/about' },
{ name: 'page/contact' },
// 共用模組自動提取到 common.js(需額外配置)
{ name: 'common', create: true, include: ['jquery', 'lodash'] }
]
uglify2: {
output: { comments: '/^!/' }, // 保留版權註釋
compress: { drop_console: false }, // 保留 console 除錯
sourceMap: true,
sourceMapUrl: 'main.js.map',
sourceMapRoot: 'https://cdn.example.com/assets/'
}
# package.json
{
"scripts": {
"build": "node r.js -o build.js",
"dev": "http-server . -p 3000"
},
"devDependencies": {
"requirejs": "^2.3.6"
}
}
優化後的代碼不需要完整 RequireJS(14KB),可改用 Almond(~1KB):
modules: [{
name: 'main',
include: ['almond'], // 將 almond 打包進入口
insertRequire: ['main'] // 自動啟動 main
}]
最終 main.js 內建微型載入器,無需額外請求 require.js。
require 不會被掃描:require([dynamicVar]) 需在 modules: [{include: ['moduleA','moduleB']}] 顯式宣告。paths: { jquery: 'empty:' } 排除打包,HTML 手動載入 CDN 版。text!、css! 外掛資源會內聯為字串,確保外掛同樣被打包。掌握 r.js 配置,讓 RequireJS 專案從開發體驗與生產效能雙贏。