专注小程序 / APP 开发,用代码改变生活

获取方案
全国分站 主站首页 北京分站 石家庄分站 唐山分站 保定分站 廊坊分站 沧州分站 郑州分站 邯郸分站

三年小程序开发:从能跑到好用的工程心得

小程序开发 2026-11-09 20 阅读 0 点赞 原创

做了三年多小程序,交付过电商、预约、工具类共十几个项目。回头看,真正拉开项目质量差距的往往不是功能多少,而是工程习惯。这篇记录我在实际项目中沉淀下来的经验,适合已经能跑通 Hello World、准备做真实项目的开发者。

三年小程序开发:从能跑到好用的工程心得

一、先把页面结构定下来,再写业务

小程序页面天然是「一页一职责」,但很多人习惯把所有逻辑塞进 onLoad,结果页面越写越重。我的做法是固定三层:

  • 页面层:只负责生命周期、参数解析、调用 service、把数据交给视图。
  • service 层:封装请求、缓存、数据整形,不依赖页面实例。
  • 组件层:把可复用的列表项、弹窗、空状态抽成自定义组件。

这样做的直接收益是调试成本下降。页面出问题时,先判断是数据没来(service 层)还是渲染没更新(页面层),排查路径清晰很多。

二、setData 是性能分水岭

小程序的逻辑层和渲染层是分离的,每次 setData 都要跨线程通信。项目做大后,卡顿八成来自这里。几条实践:

  • 只传变化字段,用路径写法,例如 this.setData({'list[3].status': 1}),不要整份 list 重设。
  • 列表分页追加时,用 concat 生成新数组一次提交,避免循环内多次 setData。
  • 与渲染无关的数据(定时器 id、请求标记、原始响应)挂在 this 上,不要放进 data。
  • 高频事件(滚动、输入)做节流,输入框用 bindinput 时不要每次按键都触发网络请求。
// 不推荐:整表覆盖
this.setData({ list: newList });

// 推荐:只更新单条
this.setData({ [`list[${index}].status`]: 1 });

三、请求层要统一收口

项目里最容易被复制粘贴污染的就是 wx.request。我的习惯是写一个 request.js,统一处理 baseURL、token 注入、错误码、loading 和超时:

function request({ url, method = 'GET', data = {}, loading = true }) {
  if (loading) wx.showLoading({ title: '加载中', mask: true });
  return new Promise((resolve, reject) => {
    wx.request({
      url: BASE_URL + url,
      method,
      data,
      header: { Authorization: wx.getStorageSync('token') || '' },
      timeout: 10000,
      success(res) {
        if (res.statusCode === 200 && res.data.code === 0) {
          resolve(res.data.data);
        } else if (res.data.code === 401) {
          wx.reLaunch({ url: '/pages/login/index' });
          reject(res.data);
        } else {
          wx.showToast({ title: res.data.msg || '请求失败', icon: 'none' });
          reject(res.data);
        }
      },
      fail(err) {
        wx.showToast({ title: '网络异常', icon: 'none' });
        reject(err);
      },
      complete() {
        if (loading) wx.hideLoading();
      }
    });
  });
}

统一收口后,换域名、加签名、改错误提示都只动一个文件,也方便后续接入云开发或自建网关。

四、云开发适合什么场景

用云开发做过两个中小型项目,结论是:没有后端团队、数据模型简单、并发不高的项目非常适合。数据库、存储、云函数一站式解决,省掉服务器和备案环节。但要注意几点:

  • 云函数冷启动明显,首屏依赖的接口尽量放前端直连数据库,或做预热。
  • 数据库权限规则要在控制台配好,别默认「所有用户可读」。
  • 复杂聚合查询和事务能力有限,业务一旦变重,迁移成本要考虑进去。

五、上线前的固定检查清单

每次提审前我都会过一遍:

  1. 体验版真机走完主流程,重点测弱网和断网重连。
  2. 检查所有 navigateTo 层级是否超过 10 层,改用 redirectTo。
  3. 图片走 CDN 并压缩,首屏大图不超过 200KB。
  4. 隐私协议、用户信息授权、类目资质是否齐全,这是审核驳回的高发区。
  5. 分包配置:主包控制在 2MB 内,非首屏页面全部拆到分包。

六、关于协作与交付

如果是接外包或与客户协作,需求文档里一定要写清楚「改几次、改什么范围」。小程序迭代快,但代码质量靠的是克制:能抽组件的别复制,能写注释的别省,版本号按语义化走。交付时附一份环境配置说明和数据库结构说明,后续维护会轻松很多。

小程序本身不难,难的是长期维护时的整洁度。把 setData、请求层、分包这三件事做扎实,大部分性能和协作问题都能提前消掉。

从开发到上线:小程序发布全流程小程序开发中值得掌握的实用技巧

评论 (0)

还没有评论,快来抢沙发吧~

好想法,值得被认真交付

从小程序、APP 到全栈网站,一站式把想法变成可落地的产品

微信咨询

微信扫码,直接沟通需求