RequireJS 透過 AMD 規範實現腳本非同步載入、依賴聲明、模組封裝,並提供 r.js 優化器解決生產環境請求過多問題。本文從引入、配置、模組定義到優化部署,提供完整實戰指南。
<script src="require.js" data-main="main"></script>
data-main="main":指定入口模組 main.js(自動補 .js),作為應用啟動點。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));
}
};
});
define。開發時模組分散,生產需合併。建立 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>
// 路由切換時按需載入
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'] |
import/export、開發伺服器熱更新、Tree Shaking、代碼分割,現代專案首選。RequireJS 完成了歷史使命,理解其原理有助於掌握現代建構工具的設計思想。