微信小程序-上传代码失败，提示分包大小超过限制

ゝ一世哀愁。 2023-10-12 18:59 31阅读 0赞

开发者可通过开发者工具中的性能扫描工具提前发现代码中的可优化项：

1. 代码包不包含插件大小超过 1.5 M

【建议】小程序代码包单个包大小限制为2M。因此我们建议开发者在开发时，如果遇到单包体积大于1.5M的情况，可以采取分包的方式，把部分代码拆分到分包去，降低单个包的体积，提升小程序的加载速度。具体可以查看文档[《使用分包》][Link 1]。

2. 引用插件大小超过 200 K

【知会】小程序插件的大小是会算进小程序代码包2M体积限制中的。因此当我们发现开发者引用的插件体积大于200K时，会对开发者予以提示，避免出现上传阶段提示代码包体积超限，但是不知道为何超限的问题。

3. 图片和音频资源大小超过 200 K

【建议】小程序代码包里可以存放一些必要的静态资源（如tabbar的icon等）；但其他非必要的静态资源体积过大会影响小程序代码包加载速度。因此我们建议图片、音频等静态资源体积大小超过200K时，将它们上传到CDN，用URL引入会是个更好的选择。

4. 主包存在仅被其他分包依赖的JS

【建议】当主包里存在一些JS文件只会被分包使用（而主包自己不使用）时，我们建议把这些JS文件从主包中拆分出去，放到对应的分包里，从而优化主包的加载速度。

5. 主包存在仅被其他分包依赖的组件

【建议】当主包里存在一些组件只会被分包使用（而主包自己不使用）时，我们建议把这些组件从主包拆分出去，并且可以使用 [分包异步化][Link 2] 这个特性加载这些组件，从而优化主包的加载速度。

6. 存在无使用的插件

【必须】如果有无使用的插件，请将其从 app.json 中去除。不然它会占用代码包体积，也会延迟代码包加载的时间。

7. 存在无使用的组件

【必须】如果在对应页面JSON的 \`usingComponents\` 里声明的组件但是没有使用，请将其从 \`usingComponents\` 里去除。

8. 未开启JS压缩

【必须】在工具「详情」-「本地设置」中开启「上传代码时自动压缩脚本文件」的设置

![152eb446a13336306fcc9a53ad05d144.png][]

9. 未开启WXML压缩

【必须】在工具「详情」-「本地设置」中开启「上传代码时自动压缩wxml文件」的设置

![5d8f1ed92da49e15b88ffe0b1b442bcc.png][]

10. 未开启WXSS压缩

【必须】在工具「详情」-「本地设置」中开启「上传代码时自动压缩样式文件」的设置

![07394a663545f9a540249b0a1751e05c.png][]

11. 存在无依赖文件

【必须】在「代码质量」面板，点击「建议去除」后，可以打开代码依赖分析面板的「无依赖文件」页面，这里可以看到代码包里没有被用到的文件。请在代码包中去除这部分文件，减小体积并优化加载速度。

在本地开发的过程中，会自动过滤无依赖的文件，如果出现误过滤的情况，可以在 project.config.json 的 [setting][] 字段中添加 ignoreDevUnusedFiles 为 false，也可以在 [packOptions ][packOptions]的 include 字段中手动将被忽略的文件引入，同时欢迎发帖反馈误报的情况提交代码片段帮助我们完善此功能

注意：页面若为配置在 app.json 中，将被识别为无依赖文件

![0f0857a426fa63c5a7d26d29ed99bc97.png][]

12. 未开启组件懒注入（按需注入）

【必须】在 app.json 中加入 \`"lazyCodeLoading": "requiredComponents"\` 可以开启小程序组件[按需注入特性][Link 3]。

[Link 1]: https://developers.weixin.qq.com/miniprogram/dev/framework/subpackages/basic.html
[Link 2]: https://developers.weixin.qq.com/miniprogram/dev/framework/subpackages/async.html
[152eb446a13336306fcc9a53ad05d144.png]: https://img-blog.csdnimg.cn/img_convert/152eb446a13336306fcc9a53ad05d144.png
[5d8f1ed92da49e15b88ffe0b1b442bcc.png]: https://img-blog.csdnimg.cn/img_convert/5d8f1ed92da49e15b88ffe0b1b442bcc.png
[07394a663545f9a540249b0a1751e05c.png]: https://img-blog.csdnimg.cn/img_convert/07394a663545f9a540249b0a1751e05c.png
[setting]: https://developers.weixin.qq.com/miniprogram/dev/devtools/projectconfig.html#setting
[packOptions]: https://developers.weixin.qq.com/miniprogram/dev/devtools/projectconfig.html#packOptions
[0f0857a426fa63c5a7d26d29ed99bc97.png]: https://img-blog.csdnimg.cn/img_convert/0f0857a426fa63c5a7d26d29ed99bc97.png
[Link 3]: https://developers.weixin.qq.com/miniprogram/dev/framework/ability/lazyload.html#%E6%8C%89%E9%9C%80%E6%B3%A8%E5%85%A5