# 分包加載 > 微信 6.6 客戶端，1.7.3 及以上基礎庫開始支持，請更新至最新客戶端版本，開發者工具請使用 1.01.1712150 及以上版本，可[點此下載](https://mp.weixin.qq.com/debug/wxadoc/dev/devtools/download.html) 某些情況下，開發者需要將小程序劃分成不同的子包，在構建時打包成不同的分包，用戶在使用時按需進行加載。 在構建小程序分包項目時，構建會輸出一個或多個功能的分包，其中每個分包小程序必定含有一個**主包**，所謂的主包，即放置默認啟動頁面/TabBar 頁面，以及一些所有分包都需用到公共資源/JS 腳本，而**分包**則是根據開發者的配置進行劃分。 在小程序啟動時，默認會下載主包并啟動主包內頁面，如果用戶需要打開分包內某個頁面，客戶端會把對應分包下載下來，下載完成后再進行展示。 目前小程序分包大小有以下限制： - 整個小程序所有分包大小不超過 4M - 單個分包/主包大小不能超過 2M 對小程序進行分包，可以優化小程序首次啟動的下載時間，以及在多團隊共同開發時可以更好的解耦協作。 ## 使用方法 假設支持分包的小程序目錄結構如下： ``` ├── app.js ├── app.json ├── app.wxss ├── packageA │ └── pages │ ├── cat │ └── dog ├── packageB │ └── pages │ ├── apple │ └── banana ├── pages │ ├── index │ └── logs └── utils ``` 開發者通過在 app.json `subPackages` 字段聲明項目分包結構： ``` { "pages":[ "pages/index", "pages/logs" ], "subPackages": [ { "root": "packageA", "pages": [ "pages/cat", "pages/dog" ] }, { "root": "packageB", "pages": [ "pages/apple", "pages/banana" ] } ] } ``` ## 打包原則 - 聲明 `subPackages` 后，將按 `subPackages` 配置路徑進行打包，`subPackages` 配置路徑外的目錄將被打包到 app（主包） 中 - app（主包）也可以有自己的 pages（即最外層的 pages 字段） - `subPackage` 的根目錄不能是另外一個 `subPackage` 內的子目錄 - 首頁的 TAB 頁面必須在 app（主包）內 ## 引用原則 - `packageA` 無法 require `packageB` JS 文件，但可以 require `app`、自己 package 內的 JS 文件 - `packageA` 無法 import `packageB` 的 template，但可以 require `app`、自己 package 內的 template - `packageA` 無法使用 `packageB` 的資源，但可以使用 app、自己 package 內的資源 ## 低版本兼容 由微信后臺編譯來處理舊版本客戶端的兼容，后臺會編譯兩份代碼包，一份是分包后代碼，另外一份是整包的兼容代碼。 新客戶端用分包，老客戶端還是用的整包，完整包會把各個 subpackage 里面的路徑放到 pages 中。 ## 示例項目 [下載 小程序示例分包加載版源碼](https://mp.weixin.qq.com/debug/wxadoc/dev/demo/demo-subpackages.zip)