夜雨聆风学习资料网

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; }
模板里直接 :src="getStaticFilePath('banner.png')" 引用即可。
CSS 里同理,用 SCSS 全局变量维护 CDN 前缀,统一改一处,全站生效。记得给图片开懒加载,别让首屏之外的图抢流量。
二、分包加载,把"非首屏"整体搬走
     分包是官方推荐的正规解法:主包只留启动必需 pages/TabBar,其余功能按业务切成若干子包,用到时才下载。   
在 pages.json 里配置 subPackages:
{   "subPackages": [     { "root": "pagesA", "pages": [...] },     { "root": "pagesB", "pages": [...] }   ] }
分包不仅压主包体积、优化首次启动,多团队协作时也能各管一包、互不干扰。注意分包之间不能互相 require 私有资源,公共代码要提到主包或 common 里。
三、打开依赖分离,别让子包代码挤进 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,就能顶掉半主包。建议:
· 按需引入,import debounce from 'lodash/debounce' 而不是整包;· moment 换成 dayjs 这类轻量替代;· 用不上的 SDK、测试期引入的库,果断删掉。
每引入一个依赖前,都先问一句:"它值这几个 KB 吗?"
八、非首屏内容,改成异步加载
对于首屏用不到的组件和库,用 异步组件或 import() 动态加载,让它们不进入主包的关键路径:
const HeavyChart = () => import('@/components/HeavyChart.vue')
九、分包不是越多越好,要"合理"
最后一条是经验之谈:分包数量和大小要匹配实际使用路径。分得太碎,用户跳转时频繁下载、体验反而变差;分得太粗,又起不到瘦身效果。
建议按业务模块 + 使用频率划分,高频功能留主包或主分包,低频长尾功能独立成包,再配合预下载策略平衡体验与体积。
写在最后
       主包瘦身不是一次性动作,而是一种习惯:图片上线 → 合理分包 → 依赖分离 → 按需引入 → 定期用依赖分析体检。把这五步变成开发流程的一部分,体积问题基本就不会再找上门。     
       你的项目主包现在多大?踩过哪个坑最狠?欢迎在评论区聊聊。     
     作者:aluo&wbd     觉得有用,点个「在看」让更多人看到 👇   

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料