SeaJS 作為經典的 CMD 模組加載器,其模組 ID 解析機制靈活但也較為複雜。本文系統梳理 base、paths、alias 及各類標識(相對、頂級、絕對、根路徑)的解析規則,並給出實戰建議。
./、../ 開頭,如 ./util。app/widget/Select,相對 base 解析。/a/b)與根路徑,相對當前頁面解析。base 預設為 sea.js 所在目錄,建議手動設定。paths 中的相對路徑在引用處替換後再解析,不同深度模組引用同一 paths 會解析到不同路徑,建議使用頂級標識或根路徑。paths 變量,規則類同,同樣建議避免相對標識。define(id, deps, factory) 中的 id(第 1 參數)推薦用頂級標識;相對標識相對當前頁面解析,易產生歧義。deps 依賴陣列(第 2 參數)與 factory 內 require() 的相對標識,均相對當前模組解析。seajs.use 的相對標識始終相對當前頁面。三處寫 ID 的地方(模組 ID、依賴 ID、require ID)字串可不同,只要最終解析為同一 URI 即視為同一模組。
base 統一管理。alias 或 paths 以非相對標識定位根目錄,再在其下定義具體 ID。paths、alias 儘量寫頂級標識、根路徑或絕對路徑,避免相對路徑導致不同深度解析不一致。