分包配置在 App 和 H5 平台是否支持

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

根据 uni-app 官方文档，分包配置 subPackages 在 H5 平台不支持，在 App 平台完全支持。

结论依据与详细说明

1. H5 平台不支持
   在 pages.json 的配置项列表中，subPackages 的“平台支持”一栏明确标注为 H5 不支持。因此，当项目运行或发行到 H5 平台时，分包策略不会生效。
   参考文档：pages.json 配置项列表

2. App 平台支持
   subPackages 配置在 App 平台是核心功能，用于优化主包体积，实现按需加载。在 HBuilderX 中开发 App 时，无论是真机运行还是云端打包，分包结构都会被正确识别和处理。你可以在 pages.json 中正常配置 subPackages 数组，并在项目的分包目录下组织代码和静态资源。

补充说明与常见误区

• App 平台分包图片加载：如果在 App 端遇到分包内本地图片加载失败的情况，可以尝试使用绝对路径引入（如 /分包目录/static/图片.png），而不是相对路径。相关问题曾在 ask 社区被反馈过。
  参考链接：App 无法加载分包图片

• H5 平台分包数量：由于 H5 平台本身不支持 subPackages 配置，因此也不存在分包数量限制的问题。如果 H5 打包出现异常，应检查其他配置而非分包数量。
  参考链接：H5 平台分包有数量限制吗

操作建议

如果你的项目需要同时兼顾 App 和 H5：

• 条件编译：可以利用条件编译，在 H5 平台下调整代码逻辑或资源路径，确保项目在无分包机制时也能正常运行。
• 资源策略：对于 H5 平台，建议将关键资源放在主包，或通过线上加载的方式处理，因为分包配置在 H5 端会被忽略，主包以外的本地静态资源可能无法正确访问。

app 的分包，同样支持 preloadRule，但网络规则无效。

是什么意思