收藏
评论

小程序性能优化指南官方

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

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

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

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

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

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

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

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

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

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

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

6. 存在无使用的插件

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

7. 存在无使用的组件

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

8. 未开启JS压缩

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

9. 未开启WXML压缩

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

10. 未开启WXSS压缩

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

11. 存在无依赖文件

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

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

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

12. 未开启组件懒注入(按需注入)

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

其他优化内容,请点击学习《小程序性能优化实践》课程


相关主页:
3133588浏览
最后一次编辑于  07-24
知识库内容非实时更新,可能已过期、失效或不适用于当前情形,请谨慎参考
收藏
反馈

137 个评论

  • :-D
    :-D
    06-03

    剑冢zxl是这样的,自己到处拉屎占空间,小程序开放npm然后限制死大小,既然你死扣大小那就关闭第三方包和框架,只允许纯正的wx语法,省的你天天挨骂

    06-03
    赞同
    回复
  • 琛盛^_^
    琛盛^_^
    05-28

    写了个小工具,解决小程序项目臃肿问题,一键清理项目中的死代码:

    ✅ 依赖图可视化 `mp-lens graph`

    ✅ 未使用文件检测 `mp-lens clean` 

    ✅ CSS冗余清理 `mp-lens purgewxss`

    ✅ 自动清理无效组件引用 `mp-lens lint --fix`

    支持TS别名、安全删除前有确认机制,告别手动排查!

    详细用法: https://github.com/chess99/mp-lens


    05-28
    赞同
    回复
  • 琛盛^_^
    琛盛^_^
    05-28

    写了个小工具,解决小程序项目臃肿问题,一键清理项目中的死代码:

    ✅ 依赖图可视化 `mp-lens graph`

    ✅ 未使用文件检测 `mp-lens clean` 

    ✅ CSS冗余清理 `mp-lens purgewxss`

    ✅ 自动清理无效组件引用 `mp-lens lint --fix`

    支持TS别名、安全删除前有确认机制,告别手动排查!

    详细用法: https://github.com/chess99/mp-lens

    05-28
    赞同
    回复
  • 琛盛^_^
    琛盛^_^
    05-28

    写了个小工具,解决小程序项目臃肿问题,一键清理项目中的死代码:

    ✅ 依赖图可视化 `mp-lens graph`

    ✅ 未使用文件检测 `mp-lens clean` 

    ✅ CSS冗余清理 `mp-lens purgewxss`

    ✅ 自动清理无效组件引用 `mp-lens lint --fix`

    支持TS别名、安全删除前有确认机制,告别手动排查!

    详细用法: https://github.com/chess99/mp-lens

    05-28
    赞同
    回复
  • 七月
    七月
    04-23

    都2025年了,能不能扩大到10MB

    04-23
    赞同
    回复
  • 风滚草
    风滚草
    04-16

    你们在评论区反馈没用的,这是大企业的通病,毕竟谁也不敢越雷池一步,得要反映到相关bu门,让相关bu门敦促企业,他们才会有所行动的  [捂脸]

    04-16
    赞同
    回复
  • 柯⃰宝🏢🤪
    柯⃰宝🏢🤪
    04-15

    插件大小也算在主包内,我也是服了。

    打包后1.8M+ 加上 chat-bot,上传报错超2M

    去掉chat-bot,就认1.8M+,上传成功

    主要是这插件本来在服务器上的吧,为啥要算在主包大小内呢?

    04-15
    赞同
    回复
  • 彭在手心
    彭在手心
    04-14

    真被恶心到了 , 用mac电脑打包就提示主包过大 , 用windows打包直接过了

    04-14
    赞同
    回复
  • 答案
    答案
    04-10

    都2025年了,还是1.5M,脑子被驴踢了!

    04-10
    赞同
    回复
  • kabu
    kabu
    04-10

    2025年了,也是这样

    04-10
    赞同
    回复

正在加载...

登录 后发表内容