记录小程序性能优化与 Skyline 迁移实战:从 1.65MB 到 0.87MB,从拖影到丝滑

2026-08-08前端8 分钟212 次阅读
AI 摘要鱼粮不足,AI 今天先歇着 · 正文在下面

一、缘起

最近在优化一个记录类小程序(记宠物日常、记宝宝成长那种)。打开项目一看,有几个不吐不快的问题:

  • 主包源码 1.65MB(加上 miniprogram_npm 总共 3.5MB+),随时可能触发官方 2MB 主包限制的红线
  • 首页 JS 一启动就要解析 592KB 的 echarts,就为了画一条折线图
  • 上下滑动首页,那个折线图一直在拖影(残影)

这篇博客把这几天的实战过程记录下来,包括一次次的试错、坑点和最终落地的方案。如果你也在维护一个"长大后失控"的小程序,希望对你有用。


二、性能优化:先把"主包大"这个老大难解决掉

第一刀:把首页的 echarts 砍了

首页有一个"数据分析"卡片,里面就一条简单的体重折线图。我打开首页 index.js 一看:

js 复制代码
import * as echarts from '../../components/ec-canvas/echarts.min';

592KB 的 echarts.min.js 被 ES Module 静态引入到首页 JS,每次冷启动都要解析。

更要命的是 components/ec-canvas/ec-canvas.js 内部也 import 了 echarts,所以只要首页 json 注册了 ec-canvas 组件,echarts 必定进主包,光改 index.js 的 import 还不够。

而首页那条折线图,数据是写死的 7 个点、淡蓝渐变面积、几条网格线——echarts 是好东西,但用在这就是杀鸡用牛刀。

我直接干了两件事:

  1. 把首页的折线图用原生 <canvas type="2d"> 手绘(约 130 行代码,复刻 echarts option 的视觉:smooth 平滑曲线 + bold 标签 + 渐变面积 + 网格)
  2. 把首页 <ec-canvas> 替换成 <canvas type="2d">,json 里移除 ec-canvas 注册

效果:首页首屏 JS 解析压力 -592KB,主包体积立刻瘦身。

第二刀:components/ec-canvas 整目录删除

首页不用 echarts 后,主包 components/ec-canvas/(含 echarts 源码)就成死代码了。但分析页 package-analysis/pages/analysis/analysis.json 注册的是 /package-analysis/components/ec-canvas/ec-canvas——它用的是分包自己的副本,跟主包这份完全独立。

我先 grep 确认了主包没有任何其他页面引用 ec-canvas,然后 git rm -r components/ec-canvas,连带 echarts.min.js 一起删。主包这下是真干净了。

注意:删除前一定要确认依赖关系。如果有分包从主包引用组件,删了主包那份会让所有引用都失效(小程序打包时把被主包引用的资源都算进主包)。

第三刀:159KB 的省市区数据搬进分包

utils/area.js 159KB 在主包,但 grep 了一圈只有两个地方用:

  • 某个分包页面(person-edit)
  • 一个地区选择组件(虽然组件在主包,但唯一引用者也是那个分包页面)

所以它本质上是"为分包服务的死重"。我把 utils/area.js 和那个组件一起搬进分包,引用路径改为分包内相对路径。

搬组件有个小诀窍:如果引用方和被引用方一起挪位置,相对路径可以不变——那个组件内部有个 tryLoad('../../utils/area'),搬完之后依然指向正确的 area.js。

第四刀:request.js 默认 loading 改 false

项目里请求封装 showLoading 默认 true。首页 Promise.all 并发 3 个请求,每个请求都调 wx.showLoading(全屏 mask 遮罩)——而 wx.showLoading 是全局单例,第一个请求返回就 wx.hideLoading,其余请求的 loading 被提前关掉,错误 toast 还可能被遮住。

改成:

js 复制代码
const config = {
    method: 'GET',
    showLoading: false,  // 默认不弹全屏 loading,由调用方按需开启
    showError: true,
    // ...
};

提交类、上传类接口如果需要阻塞提示,显式传 showLoading: true 就行。首页数据加载改用骨架屏代替全屏 loading,体验好得多。

第五刀:启动关键路径解耦

之前的启动链路是这样的:

复制代码
app.js onLaunch
  └─ await configStore.init(true)    ← 等配置接口
       └─ await 预加载 5 张关键图片(最多等 10s)  ← 串行
首页 onLoad
  └─ await appReady                   ← 轮询 50ms
       └─ loadPageData()              ← 才发数据请求

4 段网络往返首尾相接。本可并行的请求被硬性串行化了。

我把它改成"缓存秒回 + 后台刷新":

js 复制代码
// app.js onLaunch
that.globalData.appReady = true; // 立即就绪,不阻塞首页

configStore.init(false).then(config => {
    if (config) {
        that.globalData.miniappConfig = config;
    }
    // 配置后台刷新,首页数据请求可以并行发出
}).catch(err => {
    console.error('[App] 配置初始化失败:', err);
});

configStore.init(false) 时:

  • 已有缓存 → 走后台静默刷新,不阻塞
  • 无缓存 → 拉取配置,但不等待图片预加载(图片预加载放后台)

首页 onLoad 里原本 await appReady 那段可以保留——因为 appReady 立即为 true,await 立即通过。最小改动,最大收益。

顺手的小优化

  • 首页宠物头像去重:原来 wxml 里模糊背景 + 主图是同一张 URL,加载 2 次。改成两个图片组件用不同的 OSS 处理参数:模糊层 quality=10 dpr=1(生成低清小图),主图 quality=60。下载量减少 + 加载更快
  • 图表 onShow 复用:原代码每次切 tab 回来都 setData(false)→true 重挂载 + 重新初始化 echarts(220ms+ 卡顿)。改成 canvas 2d 后直接重新绘制,不再销毁重建
  • 删死代码:一个零引用且引用的本地图片都不存在的启动页组件 + miniprogram_npm/ 下的 echarts/zrender/tslib 空目录

优化成果

指标 之前 之后
主包源码 1.65MB 0.87MB(-47%)
首页 JS 解析 +592KB echarts 0
首屏数据首字节 串行 4×RTT 并行 1×RTT
切 tab 回首页 220ms 图表销毁重建 实例复用

注意:miniprogram_npm/@vant 1.9MB 还在主包。这次没做 vant 分包 npm(需要在开发者工具重新构建 npm,不适合"改完就测"),后面单独排期。


三、拖影问题:canvas 折线图的"老大难"

性能优化都做完后,用户反馈"首页折线图上下滑动还是有拖影"。

我一开始以为是 canvas 绘制逻辑问题,去查代码、看绘制参数。折腾了一圈发现是架构层面的问题:

<canvas type="2d"> 是原生组件层,跟 WebView 的页面滚动速率不同步——页面在滚,原生 canvas 层跟不上,就形成残影。这是小程序 WebView 渲染架构决定的,跟绘制代码无关。

短期方案:滚动时隐藏 canvas

行业标准做法:滚动中把 canvas 透明度置 0(隐藏原生层),停止滚动后恢复并重绘。

js 复制代码
// index.js
onPageScroll() {
    if (!this.data.showHomeAnalyticsChart) return;
    if (!this.data._canvasHidden) {
        this.setData({_canvasHidden: true}); // 首次 setData,避免每帧渲染
    }
    clearTimeout(this._scrollEndTimer);
    this._scrollEndTimer = setTimeout(() => {
        this._scrollEndTimer = null;
        this.setData({_canvasHidden: false}, () => {
            this.initHomeAnalyticsChart(); // 恢复后重绘
        });
    }, 120);
}
xml 复制代码
<!-- index.wxml -->
<canvas ... style="{{_canvasHidden ? 'opacity: 0;' : ''}}"></canvas>

效果立竿见影:滑动页面时图表区域"消失",停止 120ms 后重绘出现,不再有拖影。

但这是妥协方案——图表在滚动中视觉上是"留白",并不是真正的丝滑。而且只要哪天有个同事加了个新页面用了 canvas,又会踩同样的坑。

长期方案:迁移 Skyline

Skyline 是微信小程序下一代渲染引擎:把渲染工作从 WebView 移到原生线程,canvas/地图等原生组件与页面同层渲染,从根本上没有"原生层和 WebView 层错位"的问题。

而且 Skyline 还能让 swiper、滚动等走原生组件,性能更好。我之前看过 Skyline 的文档,一直觉得迁移成本太高没动手——但这次的拖影问题彻底治不好(短期的 hack 始终是 hack),于是决定真迁移。


四、Skyline 迁移首页实战

4.1 调研兼容性

先看一下首页用到的组件:

  • <view> / <text> / <image>:基础组件,Skyline 完全支持
  • <swiper> / <swiper-item>:Skyline 原生渲染,性能更好
  • <canvas type="2d">:Skyline 同层渲染,拖影问题根治
  • 自研导航栏 / 底部 tab:需检查是否依赖 WebView API
  • <van-skeleton>(@vant/weapp):依赖 Glass-Easel 组件框架,Skyline 必须配 componentFramework: glass-easel

我打开 app.json 一看:

json 复制代码
"style": "v2",
"componentFramework": "glass-easel",
"lazyCodeLoading": "requiredComponents"

glass-easel 已经开了,lazyCodeLoading 也开了。基础设施齐全。

4.2 决定灰度策略:只迁首页

Skyline 可以按页面级配置(page json 里写 "renderer": "skyline"),不需要全量迁移。我决定只把首页迁到 Skyline,其他页面保持 WebView——这是最小风险的灰度。

这样如果首页出问题,回滚成本极低(去掉 renderer 字段就回到 WebView),其他页面不受影响。

4.3 改 json:启用 Skyline

json 复制代码
{
  "navigationStyle": "custom",
  "enablePullDownRefresh": true,
  "renderer": "skyline",
  "rendererOptions": {
    "skyline": {
      "defaultDisplayBlock": true,
      "defaultContentBox": true,
      "disableABTest": true
    }
  },
  "usingComponents": { ... }
}

4.4 改 wxml:包 scroll-view

Skyline 下页面默认不滚动。我之前没意识到这点——WebView 下整页靠 <view class="page-content"> 撑开滚动,Skyline 下不滚。

必须把滚动区域包到 <scroll-view type="list"> 里:

xml 复制代码
<view class="page page-bg-light {{themeClass}}" style="min-height: 100vh">
    <view class="top-gradient-bg"></view>
    <custom-navigation-bar ...></custom-navigation-bar>

    <!-- Skyline 下必须用 scroll-view 包裹 -->
    <scroll-view type="list" scroll-y class="home-scroll"
                 style="height: {{pageMinHeight}}">
        <view class="page-content page-content-wrap">
            ...原有内容...
        </view>
    </scroll-view>
</view>
<custom-tab-bar></custom-tab-bar>

几个要点:

  • type="list" 是 Skyline 推荐配置,性能更好
  • scroll-y 启用纵向滚动
  • height 用 app.js 全局变量 pageMinHeight(已经算好 = 100vh - 导航栏高度)
  • 导航栏和底部 tab 不进 scroll-view,它们是 fixed

4.5 撤掉短期 hack

迁完 Skyline 后,canvas 不再拖影,onPageScroll 隐藏 canvas 的 hack 就可以撤了:

  • 删除 data._canvasHidden
  • 删除 onPageScroll 方法
  • 删除生命周期里 _scrollEndTimer 清理
  • 删除 wxml canvas 的 opacity 控制

代码清爽了不少。

4.6 一个意外的踩坑

我刚开始改 wxml 时,少加了一个 </view> 关闭最外层 <view class="page">,结果页面渲染乱了。修改多层嵌套结构时一定要数好标签对——尤其是 Skyline 下 <scroll-view> 是新加的一层。

4.7 Skyline 后的收益

迁移完后:

  • ✅ canvas 拖影彻底消失:原生同层渲染,滚动跟手
  • ✅ swiper 更丝滑:原生 swiper,多个卡片展示不再掉帧
  • ✅ 页面滚动更跟手:渲染线程化,长列表不阻塞逻辑层
  • ✅ 未来可玩 worklet 动画:UI 线程手写弹簧/缓动,给按钮等加交互动效

五、顺手修的一个小 bug:任务列表"去分享"按钮过宽

checkin 页"每日任务"列表里,"去分享"按钮比其他两个大很多(占满整行右侧)。

排查发现:

  • 前两个按钮("去完成"、"已完成"、"领取")用的是 <view class="task-btn">
  • "去分享"按钮用的是 <button class="task-btn" open-type="share">

小程序 <button> 有自己的用户代理样式——padding、border、min-height、默认 display 等,.task-btn 类的样式(虽然有 border:none; padding:0)被 button 的 UA 样式覆盖了,撑成父容器宽度。

而且 open-type="share" 必须 <button> 才有,没法换成 view。

修复:显式重置 button.task-btn 的所有 UA 样式:

css 复制代码
/* 重置小程序 <button> 默认样式(去分享按钮用 button,必须显式重置) */
button.task-btn {
    min-height: 56rpx;
    font: inherit;
    line-height: 56rpx;
    text-align: center;
    background: var(--theme-primary);
    color: #fff;
    border: none;
    border-radius: 28rpx;
    padding: 0 24rpx;
    margin: 0;
    box-sizing: border-box;
}
button.task-btn::after { border: none; }

效果:去分享按钮变得和上面一样紧凑。

教训:凡是 <button> 元素,都必须显式重置 UA 样式(border、padding、min-height、::after 边框),不然一定会被默认样式污染。


六、经验总结

几个想说的点:

1. "主包瘦身"是个长期工程

这次一次性砍了 800KB(-47%),但剩下的 870KB 仍然有优化空间(vant 1.9MB 还在主包)。下一次应该做 vant 分包 npm:配置 subPackages[].miniprogramNpmDistDir,把 @vant/weapp 整个移出主包。这需要重新构建 npm,建议另起一轮。

2. 短期 hack vs 长期方案要分清

onPageScroll 隐藏 canvas 是个短期 hack,能解决问题但不解决根因(WebView 渲染架构)。Skyline 才是长期方案。这次迁移 Skyline 是必要的——hack 留给后人维护会出更多问题。

3. 灰度迁移,不要一把梭

Skyline 全量迁移风险大(每个页面都要适配)。我的做法是只迁首页——page json 里加 "renderer": "skyline" 是页面级的,其他页面不受影响。出问题回滚也容易。

4. canvas 在 WebView 下就是个"原住民问题"

很多小程序教程会让你用 cover-view + position: fixed 包原生组件避免滚动错位,但本质都是 hack。Skyline 才是正经出路——它的"同层渲染"设计就是为了根治这个问题。

5. 写技术博客是给自己最好的复盘

这篇博客里"四、Skyline 迁移首页实战"那一节,写完之后我才发现自己中途漏了一个 </view>——这种事在开发过程中没注意到,写出来才回看代码看到。博客就是最好的强制复盘工具。


七、最后

性能优化不是一次性的工作。这次砍了 echarts、删了死代码、迁了 Skyline,但后面还有:

  • vant 分包 npm(-1.9MB 主包)
  • 其他页面灰度迁 Skyline
  • 启动链路进一步优化(首屏数据预拉、缓存更激进一点)
  • 监控埋点(启动时长、各页面首屏耗时、接口耗时)

但这次干完,最痛的那几个点(包体大、启动慢、canvas 拖影)都解决了。小程序跑起来明显轻快了很多——这才是开发最有成就感的时刻。

如果你也在做小程序性能优化,欢迎交流。我的经验是:先看主包大小 → 看启动关键路径 → 看高频交互页(首页/详情页) → 看是否有 WebView 兼容性问题。按这个顺序排查,基本能解决 80% 的体验问题。

共勉。

觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句