UniApp分包优化实战:解决uni_modules被打包到主包问题

一、背景

不少开发者都遇到过主包体积超出限制，把部分组件放在分包uni_modules中，但是打包之后发现分包的uni_modules还是被打包到了主包中。本文分享这一问题的解决方案。

二、配置步骤

1. 分包优化配置

需要在manifest.json指定小程序节点下添加分包优化配置，开启subPackages优化。

2. 主分包的uni_modules目录结构

主包的uni_modules要放在主包的根目录下，分包的uni_modules要放在分包的根目录下。

3. 配置easycom引入规则

在pages.json中配置组件easycom引入规则，这一步是为了避免同一个组件库被主包分包都使用，出现识别错误的问题。

例如，主包用组件就写rice-button，分包用组件就写sub-rice-avatar，通过前缀区分。

三、示例项目

测试项目请查看DCloud官方文档。

来源:微信公众号
发布时间:2026年5月
核心观点:通过在manifest.json开启分包优化，配置正确的目录结构和easycom规则，解决uni_modules被错误打包到主包的问题。