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

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

微信小程序云开发实战:从零搭建一个记账本

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

一个人做小程序,最耗时间的往往不是写页面,而是后端。服务器、域名、备案、数据库、接口鉴权,任何一项都能把周末吞掉。微信小程序云开发把这一层收进了平台内部,对独立开发者来说,是当前投入产出比很高的一条路径。这篇文章用一个记账本小程序做例子,把从初始化到上线的关键环节走一遍。

微信小程序云开发实战:从零搭建一个记账本

一、项目初始化与目录结构

在微信开发者工具中新建项目,选择「云开发」模板,填写 AppID 后即可获得一个带云函数目录的骨架。建议的目录结构如下:

miniprogram/
  pages/
    index/       # 账单列表
    add/         # 新增账单
    stats/       # 统计
  components/
  utils/
cloudfunctions/
  addBill/
  listBills/
  statsBills/
project.config.json

project.config.json 中需要确认 cloudfunctionRoot 指向 cloudfunctions/,否则右键云函数目录时不会出现「上传并部署」选项。

二、数据模型设计

记账本的核心集合只有一个 bills,字段尽量扁平,避免嵌套查询:

  • _openid:云开发自动写入,天然实现按用户隔离
  • amount:金额,单位分,用整数避免浮点误差
  • type:income 或 expense
  • category:分类标识,如 food、traffic
  • remark:备注,可空
  • createdAt:服务端时间戳

金额用「分」存储是一个值得坚持的习惯。用元存浮点数,做月度汇总时会出现 0.1 + 0.2 这类经典问题,展示层再除以 100 即可。

三、云函数与数据库权限

云开发数据库的权限建议设为「仅创建者可读写」,这样客户端直接调用 wx.cloud.database() 也能保证数据隔离。但涉及聚合统计时,客户端能力有限,需要走云函数:

// cloudfunctions/statsBills/index.js
const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })
const db = cloud.database()
const $ = db.command.aggregate

exports.main = async (event) => {
  const { OPENID } = cloud.getWXContext()
  const { start, end } = event
  const res = await db.collection('bills')
    .aggregate()
    .match({
      _openid: OPENID,
      createdAt: _.gte(new Date(start)).and(_.lt(new Date(end)))
    })
    .group({
      _id: '$type',
      total: $.sum('$amount')
    })
    .end()
  return res.list
}

注意 cloud.getWXContext() 拿到的 OPENID 由平台注入,客户端无法伪造,这比自己在请求体里传用户 ID 安全得多。

四、页面与交互的几个细节

1. 新增页面的表单校验

金额输入使用 type="digit",失焦时统一转成分。提交前做一次非空与范围校验,避免无效请求打到云函数。

2. 列表分页

首页用 onReachBottom 触发加载,每次取 20 条,用 createdAt 倒序加 skip 实现。数据量变大后建议改成游标分页,记录上一页最后一条的时间戳,避免 skip 在深分页时变慢。

3. 统计页的渲染

统计结果只有几个数字,直接在 onShow 里调用云函数并把结果 setData 即可,不需要引入图表库。真要画趋势图,可以用 canvas 2d 手写折线,体积比第三方库小很多。

五、性能与体验优化

  • 云函数冷启动是首屏延迟的主要来源,把统计逻辑合并到一个函数里,减少调用次数
  • 列表页图片与图标使用本地资源或 image 的 lazy-load
  • 频繁读写的配置项放进 wx.setStorageSync 做本地缓存,减少数据库读次数
  • 开启云开发的「数据库索引」,给 _openid + createdAt 建复合索引,查询耗时会明显下降

六、上线前的检查清单

提交审核前,把这几件事做完:小程序名称与类目匹配,隐私协议中声明收集的数据范围,云开发环境切换为正式环境并确认配额,体验版走一遍完整流程(新增、删除、统计、空数据状态)。审核被拒最常见的原因是类目与实际功能不符,以及隐私声明缺失,提前对齐可以省下一轮等待。

云开发并不适合所有场景,但当你的产品是「一个人维护、用户量在可控范围、以工具属性为主」时,它能把后端成本压到接近于零。把省下来的时间放在交互细节和数据准确性上,对独立开发者来说,这才是真正的杠杆。

小程序外包:从需求到上线的协作要点微信小程序定制开发全流程拆解

评论 (0)

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

好想法,值得被认真交付

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

微信咨询

微信扫码,直接沟通需求