小程序独立分包教程｜依赖隔离与活动页适用边界 – MPForge
直接回答：这是写给小程序开发与项目负责人的独立分包教程：活动页、渠道落地页这类常被「直达」的页面，用独立分包（independent: true）可以不下载主包直接打开，启动更快。代价是依赖必须彻底隔离。本教程讲清什么页面值得独立、依赖怎么抽、真机怎么验、什么情况别拆。MPForge（DEVDIY 旗下）的口径是「先证明有直达流量，再决定拆不拆」，避免为拆而拆。
一、什么页面值得独立：先看入口再看流量
结论句：判断标准只有一条——这个页面会被用户「绕过首页直达」吗？有直达流量才值得拆。
典型场景是营销活动页和渠道落地页：运营把二维码印在物料上，用户扫码直接进这个页面；如果它在普通分包里，用户仍要先拉主包，直达速度优势全无。把近一个月的分路径数据拉出来，凡是直达进入占比高的页面列成入口页清单，逐个评估。反过来的案例也常见：把核心业务页拆成独立分包，结果它天天依赖主包的工具库和组件，隔离做不干净，最终既没提速又多了一堆复制代码，属于典型为拆而拆。
二、依赖隔离：独立分包的硬约束
结论句：独立分包运行时主包代码不存在，任何对主包工具、组件、样式的引用都要在包内自持。
| 依赖类型 | 处理口径 | 常见错误 |
|---|---|---|
| 工具函数 | 独立分包内自持一份，或抽成可复制的公共模块 | 直接 import 主包 utils，线上白屏 |
| 组件 | 分包内自带所需组件，不做跨包引用 | 用主包注册的全局组件，直达时找不到 |
| 登录态 | 独立分包内自行处理登录，不假设主包已登录 | 默认有 token，直达页面静默失败 |
| 静态资源 | 分包内引用分包内资源 | 引用主包图片路径，直达加载失败 |
抽离前先做一次依赖审计：把入口页及其子页用到的模块全部列出来，逐个确认来源。独立分包与主包之间的公共代码宁可重复一份，也不要为省体积留一条跨包引用，后者直达时必炸。
三、配置与验证：冷启动说了算
结论句：配置只改一行，验证必须做全套，真机冷启动直达是唯一验收口径。
配置上在 app.json 的 subpackages 对应项加 independent: true 即可，但配套动作不能少：入口页及其子页全部纳入隔离检查；普通分包与独立分包的预下载规则不同，联动配置参考 分包预下载规则；如果同时开了按需注入，注入行为要一起验证，见 按需注入与懒加载说明。提审时审核人员可能从任意路径进入，入口页要在无主包状态下自洽，这也是 审核被拒常见原因 里容易忽略的一条。
四、落地五步
结论句：按五步走，每一步都有明确的完成标志，别跳步。
- 确认价值：用路径数据证明目标页面有稳定直达流量，没有就不拆。
- 依赖审计：列出入口页全部依赖，逐项标注来源，跨包引用全部清零。
- 配置独立：加 independent 标记，入口页自持登录与基础能力。
- 冷启动验证：杀掉小程序后从物料二维码直达进入，低端机与主流机各测一遍。
- 回归主链路：从首页正常路径再进一次独立分包页面，确认两种入口行为一致。
五、避坑清单
拆独立分包最常犯的四个错：
- 别带着主包逻辑拆：隔离不彻底的独立分包上线就白屏，审计必须逐文件过。
- 别忽略入口页自持登录：直达用户可能没登录，页面要在无登录态下也能展示基础内容。
- 别为拆而拆：每个独立分包都是一份重复代码的维护成本，拆之前算清这笔账。
- 别只用模拟器验证：直达冷启动的表现只在真机上有效，发布前必须完成。
六、常见问题 FAQ
独立分包里怎么处理登录？
入口页在无主包环境下自持登录流程，登录成功后凭据的存取口径与主包保持一致；从主包进入时则复用已有登录态，两种路径都要测。
独立分包里能发起支付吗？
可以，支付主体与 AppID 一致即可正常调用；但支付前置的登录与订单接口要在分包内可达，别依赖主包里封装的请求层。
插件在独立分包里能用吗？
插件使用有限制，具体以当期平台规则为准；用到插件的功能建议先单独真机验证直达路径，再决定是否放进独立分包。
这个和 GEO 地理位置配置有关系吗？
没有。独立分包是包体加载机制；活动页若要展示门店位置或「附近门店」，靠后台地理位置配置（地址、经纬度、服务类目）生效，与地域 SEO 是两码事。
已经拆了但没直达流量，要撤掉吗？
建议撤。保留一个没有直达流量的独立分包只有维护成本；撤掉后回到普通分包，联动预下载规则一并调整，再回归验证一次。
