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

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

小程序开发实录:一个工具类小程序的完整开发过程

小程序开发 2026-11-10 17 阅读 0 点赞 原创

这个项目是一个面向本地生活服务的工具类小程序,核心功能是让用户按距离和分类查找附近的维修点,并支持收藏与分享。从立项到提交审核一共用了三周,下面按实际推进顺序记录关键决策和代码。

小程序开发实录:一个工具类小程序的完整开发过程

需求收敛与技术选型

需求最初列了十几个功能,最后只保留三条主线:列表检索、详情展示、收藏。判断标准很简单——没有它小程序就无法闭环的功能留下,其余全部放到第二版。这一步直接决定了工期可控。

技术栈上选择了微信小程序原生框架加云开发。理由有三个:

  • 没有独立的服务端运维需求,云函数和云数据库足够支撑查询与写入;
  • 用户身份直接使用 openid,省去登录体系;
  • 地图、定位、分享等能力都是平台原生组件,接入成本低。

数据模型与云数据库设计

云数据库建了三张集合:shops 存维修点信息,favorites 存用户收藏关系,categories 存分类字典。查询以地理位置为主,因此 shops 中保存 location 地理坐标字段,并建立索引。

// shops 文档结构示例
{
  _id: "shop_001",
  name: "城东家电维修",
  categoryId: "cat_02",
  location: { type: "Point", coordinates: [114.52, 36.61] },
  address: "XX路 12 号",
  phone: "13800000000",
  rating: 4.6
}

收藏关系用 openid + shopId 做唯一约束,避免重复写入。云函数里先查后写,配合数据库权限设置为“仅创建者可读写”,前端不直接操作集合。

核心页面实现

列表页的定位与检索

进入页面先调用 wx.getLocation 获取坐标,再请求云函数按距离排序返回附近数据。定位失败时降级为按城市默认坐标查询,保证页面不会空白。

Page({
  data: { list: [], loading: true },
  onLoad() {
    this.fetchList();
  },
  async fetchList() {
    try {
      const { latitude, longitude } = await wx.getLocation({ type: 'gcj02' });
      const res = await wx.cloud.callFunction({
        name: 'getNearbyShops',
        data: { latitude, longitude, categoryId: this.data.categoryId }
      });
      this.setData({ list: res.result.data, loading: false });
    } catch (e) {
      this.useFallbackCity();
    }
  }
})

详情页与收藏状态同步

详情页需要同时展示商家信息和当前用户的收藏状态。做法是在云函数中一次性返回两者,减少一次网络往返。收藏按钮点击后先本地切换 UI,再异步写库,失败时回滚并提示。

性能与体验优化

上线前做了一轮针对性优化,收益比较明显的有三点:

  • 列表分页:每页 20 条,滚动到底部再加载,首屏渲染时间从约 900ms 降到 300ms 左右;
  • 图片懒加载:列表缩略图使用 lazy-load,并统一走云存储的图片处理参数压缩尺寸;
  • 减少 setData 数据量:只更新变化的字段,避免整列表重设,滚动时掉帧明显减少。
经验是:小程序性能问题大多不是框架造成的,而是 setData 传了过多数据、图片没压缩、页面层级过深。先把这三点处理掉,再考虑更复杂的方案。

上线流程与后续计划

提交审核前补齐了隐私协议、用户信息收集说明,并确认所有网络请求域名都在白名单内。审核一次通过,用时约一天半。上线后通过云开发控制台观察调用量和错误日志,发现定位失败率偏高,补充了手动选择位置的入口。

第二版计划加入搜索联想和评价功能,同时把云函数中重复的权限校验逻辑抽成公共模块。整个开发实录说明一件事:把范围压小、把数据流理清,一个人也能在较短时间内交付一个可用的小程序。

小程序开发分享:从需求到上线的完整路径小程序开发入门:从零到上线

评论 (0)

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

好想法,值得被认真交付

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

微信咨询

微信扫码,直接沟通需求