從 Grunt + RequireJS 換到 gulp + SeaJS 之後,模塊合並壓縮的問題跟了過來。npm 上並沒有特別流行的 SeaJS 專用 gulp 插件,SeaJS 官方 repo 的相關 issue 裡,多數方案也只做到「把所有模塊打成一個檔案」——這對單頁應用沒問題,但對多頁應用而言,等於放棄了按需加載這個模塊化的核心價值。
本文記錄一個可行做法:只合並各頁面真正依賴的模塊,並允許指定某些模塊排除在合並之外。
像 jQuery、Bootstrap 這類第三方庫,檔案大、幾乎不改動,若被打進頁面主檔,就永遠無法單獨更新快取。把它們留在獨立檔案裡,反而能長期利用瀏覽器緩存。所以合並策略需要兩條規則:只合並頁面依賴的模塊,且可指定某些路徑不參與合並。
demo 有兩個頁面 login.html 與 regist.html,模擬多頁應用:
https://liuyunzhuge.github.io/blog/seajs/dist/html/login.html
https://liuyunzhuge.github.io/blog/seajs/dist/html/regist.html
以 login.html 為例,原始碼中除了 SeaJS 與配置檔 common.js,只引用了 app/login 作為頁面主模塊:

實際上 login.js 還依賴更多模塊,從 Chrome 的 Sources 面板可以看到完整載入的資源清單:


合並前 login.js 的內容:

合並後,mod/mod1.js、mod/mod2.js、deps/fastclick.js 這三個模塊都消失了,只剩 login.js,而 lib/bootstrap.js、lib/jquery.js、lib/jquery.validate.js 依然獨立。這正是我們要的結果:js/lib 下的模塊保持獨立以利用快取,頁面主模塊依賴的其他模塊則全部內聯。
完整原始碼:https://github.com/liuyunzhuge/blog/tree/master/seajs

這個結構借用自 RequireJS,盡量扁平,中小型前端專案夠用:
js/app:各頁面的主模塊,大致一個頁面一個檔案。js/deps:需要被合並進主模塊的第三方模塊。js/lib:不參與合並的第三方模塊。js/mod:專案自行開發的模塊。common.js:SeaJS 配置檔。
把 js/lib 下的模塊都寫進 alias。因為這些檔案不參與合並,需要長期快取,透過 alias 可以在升級檔案時只改一處版本路徑,不必動業務代碼。
base 設定為 js 目錄。個人習慣是 require 時一律寫 mod/mod1 這樣的完整標識而非相對路徑,即使互相依賴的模塊就在同一層——把 base 設在 js 底下,感覺像有個站點根目錄,重構搬檔案時也更省心。

兩個關鍵插件:gulp-seajs-transport 與 gulp-seajs-concat(更完整的 gulpfile.js 請見開頭的原始碼連結)。
為什麼不能直接 concat。SeaJS 的匿名模塊在合並後會失去所屬路徑資訊,因此必須先轉成具名模塊。合並前:

經過 transport 處理後:

模塊 ID 被補上,依賴也透過 define 的第二個參數描述清楚,這之後才能交給 gulp-seajs-concat 合並。相關討論可參考 https://github.com/seajs/seajs/issues/426。
gulp-seajs-concat 本身用法很簡單,只要傳一個 base 選項,且必須與 common.js 中的 base 一致——它靠 base 加上 transport 後的模塊資訊去找出所有依賴檔案。

use 的參數名稱必須與合並後主模塊的 ID 完全一致。合並後的 app/login.js 長這樣:

檔案裡有多個 define,第一個對應的就是主模塊,紅框處即其 ID。SeaJS 有「ID 與路徑匹配」規則:當一個檔案包含多個模塊時,use 會依參數名去找主模塊,必須完全匹配才找得到。名字寫錯的話,檔案雖然載入成功,模塊內的程式碼卻一行都不會執行——這是最容易踩的坑。

使用 gulp-uglify,但 mangle 選項必須排除 require、exports、module 這幾個名稱,否則會引發難以追蹤的問題。
整套流程不複雜,但從 Grunt + RequireJS 遷移過來時仍花了不少時間摸索,主要卡在 transport 這一步的必要性與 use 參數必須對齊主模塊 ID 這兩個細節。若你的專案是 SeaJS 多頁應用,這套「按頁面合並 + lib 獨立快取」的策略應該能直接套用。