萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

優化 RequireJS 專案實戰:r.js 合併壓縮、多頁應用與建構流程整合

開發階段模組分散利於維護,生產環境若仍發送數十個 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 握手、標頭開銷累積可觀。

r.js 優化器核心能力

  • **追蹤依賴圖**:從入口模組遞迴分析 define/require 依賴。
  • **合併檔案**:將所有模組包裝在單一檔案,按依賴順序排列。
  • **壓縮代碼**:支援 UglifyJS(預設)、Closure Compiler、或不壓縮。
  • **CSS 優化**:合併 @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%+,首屏載入時間顯著下降。

進階技巧

1. 多頁應用:多入口各自優化

modules: [
  { name: 'page/home' },
  { name: 'page/about' },
  { name: 'page/contact' },
  // 共用模組自動提取到 common.js(需額外配置)
  { name: 'common', create: true, include: ['jquery', 'lodash'] }
]

2. 保留 Source Map 除錯

uglify2: {
  output: { comments: '/^!/' }, // 保留版權註釋
  compress: { drop_console: false }, // 保留 console 除錯
  sourceMap: true,
  sourceMapUrl: 'main.js.map',
  sourceMapRoot: 'https://cdn.example.com/assets/'
}

3. 整合至建構流程

# package.json
{
  "scripts": {
    "build": "node r.js -o build.js",
    "dev": "http-server . -p 3000"
  },
  "devDependencies": {
    "requirejs": "^2.3.6"
  }
}

4. Almond:生產環境輕量 AMD 載入器

優化後的代碼不需要完整 RequireJS(14KB),可改用 Almond(~1KB):

modules: [{
  name: 'main',
  include: ['almond'], // 將 almond 打包進入口
  insertRequire: ['main'] // 自動啟動 main
}]

最終 main.js 內建微型載入器,無需額外請求 require.js。

避坑指南

  • 動態 require 不會被掃描:require([dynamicVar]) 需在 modules: [{include: ['moduleA','moduleB']}] 顯式宣告。
  • CDN 外部依賴:paths: { jquery: 'empty:' } 排除打包,HTML 手動載入 CDN 版。
  • 非 JS 資源:text!、css! 外掛資源會內聯為字串,確保外掛同樣被打包。

掌握 r.js 配置,讓 RequireJS 專案從開發體驗與生產效能雙贏。

copyright © 萬盛學電腦網 all rights reserved