萬盛學電腦網

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

使用 RequireJS 優化 JavaScript 載入:模組化、依賴管理與建構部署

RequireJS 透過 AMD 規範實現腳本非同步載入、依賴聲明、模組封裝,並提供 r.js 優化器解決生產環境請求過多問題。本文從引入、配置、模組定義到優化部署,提供完整實戰指南。

快速引入

<script src="require.js" data-main="main"></script>
  • data-main="main":指定入口模組 main.js(自動補 .js),作為應用啟動點。
  • RequireJS 載入後,以 main.js 所在目錄為 baseUrl,非同步載入並執行入口。

載入依賴:require

// main.js
require.config({
  paths: {
    // 別名指向 CDN,無需 .js 後綴
    'jquery': 'https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min'
  }
});

require(['jquery'], function($) {
  // 此處 $ 為 jquery 模組匯出值
  $('#app').html('Hello RequireJS + jQuery!');
});

定義模組:define

// utils/math.js - 無依賴
define(function() {
  return {
    add: (x, y) => x + y,
    mul: (x, y) => x * y
  };
});

// components/greeting.js - 依賴 jquery、math
define(['jquery', 'utils/math'], function($, math) {
  return {
    greet: function(selector, name) {
      $(selector).text('Hello, ' + name + '! 1+2=' + math.add(1,2));
    }
  };
});

模組定義關鍵規則

  • **一檔一模組**:慣例每個 .js 只定義一個 define。
  • **依賴前置**:陣列中順序對應 factory 參數順序。
  • **返回值即模組公開 API**:物件、函數、類別均可。
  • **不污染全域**:模組內變數預設私有,僅透過返回值暴露。

優化部署:r.js 合併壓縮

開發時模組分散,生產需合併。建立 build.js:

({
  baseUrl: 'js',
  name: 'main',
  out: 'dist/main-built.js',
  paths: {
    'jquery': 'empty:' // 排除 jquery,改用 CDN
  },
  optimize: 'uglify2',
  uglify2: { output: { beautify: false } }
})
node r.js -o build.js

產出 dist/main-built.js 包含所有本地模組,HTML 改為:

<script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
<script src="dist/main-built.js"></script>

進階:非同步載入(Lazy Loading)

// 路由切換時按需載入
define(['require'], function(require) {
  return {
    loadAdminPanel: function() {
      require(['admin/panel'], function(AdminPanel) {
        AdminPanel.init();
      });
    }
  };
});

配合路由器(如 Backbone.Router、React Router)實現代碼分割,首屏只載核心模組。

常見問題速查

| 現象 | 原因 | 解決 | |------|------|------| | Mismatched anonymous define() | 多個 define 在同一檔、或未正確關閉 | 檢查檔案結構、確保單一 define | | 模組載入 404 | paths 路徑錯誤、baseUrl 誤解 | 用 Network 面板看實際請求 URL,調整 baseUrl/paths | | 依賴順序錯誤 | 非 AMD 腳本未 shim | 在 config.shim 宣告 deps/exports | | 優化後報錯 require is not defined | 入口模組未包含在打包、或未 insertRequire | 檢查 modules.name、加 insertRequire: ['main'] |

現代替代者

  • ES Modules + Vite/Webpack:原生 import/export、開發伺服器熱更新、Tree Shaking、代碼分割,現代專案首選。
  • SystemJS:瀏覽器端動態 ES Module 載入器,適合微前端、動態微模組。

RequireJS 完成了歷史使命,理解其原理有助於掌握現代建構工具的設計思想。

copyright © 萬盛學電腦網 all rights reserved