收藏
评论

小程序性能优化指南官方

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

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"` 可以开启小程序组件按需注入特性

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


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

139 个评论

  • 㣻罖
    㣻罖
    2025-04-18

    1.5M还是太大了,建议整个1.5kb吧,放个链接进去,整不活了

    2025-04-18
    赞同 1
    回复
  • 故梦
    故梦
    2025-02-12

    上面方法都试过以后,如果主包还是过大,试试删掉unpackage这个文件夹,再检测一遍

    2025-02-12
    赞同 1
    回复
  • 南露
    南露
    2025-01-23

    听君一席话胜似一句话

    2025-01-23
    赞同 1
    回复
  • 换个星球好好生活
    换个星球好好生活
    2024-11-27

    2024了哥们儿 主包为什么越来越小了阿 官方脑子是不是移植猪脑阿?

    2024-11-27
    赞同 1
    回复
  • QJT
    QJT
    2024-07-11

    2024年七月了,坐等主包上传限制提升到8M,我相信官方一定能优化迭代的更好的~

    2024-07-11
    赞同 1
    回复
  • Tiga
    Tiga
    2024-05-17

    垃圾货


    2024-05-17
    赞同 1
    回复
  • Amin
    Amin
    2023-09-15

    无使用的组件扫描应该有漏了的情况,如果组件被模板包含和引用的时候,组件引用会被漏扫

    // a.wxml
    <template name="sub-com">
      <x-com data="{{ conf.data }}" />
    </template>
    
    // b.wxml
    <template is="sub-com" />
    
    2023-09-15
    赞同 1
    回复
  • JJOD
    JJOD
    2023-09-07

    怎么用新版本上传就报超出限制,同一套代码旧版本就可以,难绷

    2023-09-07
    赞同 1
    回复 1
    • ·x·
      ·x·
      2025-08-07
      我也遇到了,一直找不到原因
      2025-08-07
      回复
  • 十里八乡的俊后生
    十里八乡的俊后生
    2023-09-04

    不会吧,不会吧,都2023了,咋还限制2M,这官方文档,写的这特么官方,看了跟没看一样

    2023-09-04
    赞同 1
    回复
  • 寒冬里的萤火虫
    寒冬里的萤火虫
    2023-08-03

    2023年了,我建议你们,还是不要乱建议了

    2023-08-03
    赞同 1
    回复

正在加载...

登录 后发表内容