ARTICLE · 1379801
主包又双叒超 2M?uni-app 小程序瘦身,这 9 招我亲测有效
主包又双叒超 2M?uni-app 小程序瘦身,这 9 招我亲测有效uni-app · 性能优化实战 主包又双叒超 2M?uni-app 小程序瘦身,这 9 招我亲测有效 文 / aluo&wbd · 阅读约 6 分钟 做过 uni-app 小程序的同学一定对这个提示不陌生:「主包体积超过 2M,请分包或减少资源」。主包一大,首次启动就慢,用户在弱网下甚至直接卡在 loading。本文把我踩过的坑和验证有效的 9 个方法整理成一份清单,按需取用即可。 一、先把图片挪上线,别再往 static 里塞 这是见效最快的一招。static 目录下的图片会原样打进主包,几张 banner 就能吃掉几百 KB。 做法很简单:把 static 里的图片统一上传到图片服务器(或对象存储 CDN),然后在代码里用全局变量拼出线上地址: // main.js 里挂全局 Vue.prototype.staticDir = 'https://www.example.com/wx/static/'; Vue.prototype.getStaticFilePath = function (url) { return Vue.prototype.staticDir + url; } 模板里直接 CSS 里同理,用 SCSS 全局变量维护 CDN 前缀,统一改一处,全站生效。记得给图片开懒加载,别让首屏之外的图抢流量。 二、分包加载,把"非首屏"整体搬走 分包是官方推荐的正规解法:主包只留启动必需 pages/TabBar,其余功能按业务切成若干子包,用到时才下载。 在 { "subPackages": [ { "root": "pagesA", "pages": [...] }, { "root": "pagesB", "pages": [...] } ] } 分包不仅压主包体积、优化首次启动,多团队协作时也能各管一包、互不干扰。注意分包之间不能互相 三、打开依赖分离,别让子包代码挤进 vendor.js 很多人分包之后发现主包没小多少,元凶往往是 子包的 JS 被打进了主包的 vendor.js。这个坑在 manifest.json 里一行配置就能堵上: // manifest.json → mp-weixin "optimization": { "subpackages": true } 改完记得重新发行,对比一下 vendor.js 体积——这一项经常被忽略,收益却很直接。 四、发行时勾选"压缩代码" HBuilderX 里两个地方要留意: ① 运行到小程序时,确认运行时是否压缩代码;② 正式发行时,选择「发行 → 小程序-微信」并勾选压缩选项。 压缩会去掉注释、空白并做变量混淆,对 JS 体积的削减立竿见影。开发阶段可以关掉方便调试,上线前务必打开。 五、用微信开发者工具做"代码依赖分析" 别凭感觉优化。打开微信开发者工具的 「详情 → 代码依赖分析」(或「构建 npm」后的体积分析),可以清楚看到: · 主包 / 各分包各自占了多少· vendor.js 里到底塞了哪些库· 哪些大文件是重复或多余的 先量再改,把力气花在真正占体积的那几个文件上,效率最高。 六、砍掉不必要的静态资源 图片、字体、图标是体积大户,逐项自查: · 图片:能用 WebP 就不用 PNG/JPG,UI 稿导图先压缩;· 图标:用 iconfont 字体图标或 SVG 代替一堆小图;· 字体:中文字体动辄几 MB,尽量用系统字体,真要自定义就做子集化,只保留用到的字。 很多"体积超标"其实只是几张没压缩的图在作祟。 七、给第三方库"瘦身" 一个 lodash 全量包、一个 moment,就能顶掉半主包。建议: · 按需引入, 每引入一个依赖前,都先问一句:"它值这几个 KB 吗?" 八、非首屏内容,改成异步加载 对于首屏用不到的组件和库,用 异步组件或 const HeavyChart = () => import('@/components/HeavyChart.vue') 九、分包不是越多越好,要"合理" 最后一条是经验之谈:分包数量和大小要匹配实际使用路径。分得太碎,用户跳转时频繁下载、体验反而变差;分得太粗,又起不到瘦身效果。 建议按业务模块 + 使用频率划分,高频功能留主包或主分包,低频长尾功能独立成包,再配合预下载策略平衡体验与体积。 写在最后 主包瘦身不是一次性动作,而是一种习惯:图片上线 → 合理分包 → 依赖分离 → 按需引入 → 定期用依赖分析体检。把这五步变成开发流程的一部分,体积问题基本就不会再找上门。 你的项目主包现在多大?踩过哪个坑最狠?欢迎在评论区聊聊。 作者:aluo&wbd 觉得有用,点个「在看」让更多人看到 👇
:src="getStaticFilePath('banner.png')" 引用即可。pages.json 里配置 subPackages:require 私有资源,公共代码要提到主包或 common 里。import debounce from 'lodash/debounce' 而不是整包;· moment 换成 dayjs 这类轻量替代;· 用不上的 SDK、测试期引入的库,果断删掉。import() 动态加载,让它们不进入主包的关键路径:














































































