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

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

从零制作一个小程序:我的完整开发手记

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

过去两周,我把一个「每日记账」小工具从想法做成了能上线的小程序。整个过程没有外包、没有团队,只有一台笔记本和零散的下班时间。这篇文章记录我实际走过的路径,包括技术选型、目录结构、关键代码和上线前的准备,给同样想自己动手的人一个可参照的样本。

从零制作一个小程序:我的完整开发手记

先想清楚:这个小程序解决谁的什么问题

动手写代码之前,我花了半天把需求收敛到一句话:让用户在三秒内记下一笔支出,并能看到本月分类占比。围绕这句话,功能被砍到只剩三块:

  • 快速记账:金额、分类、备注,一键保存
  • 月度统计:按分类聚合,用进度条展示占比
  • 数据同步:换设备不丢数据

需求越窄,后面每一行代码的取舍就越清晰。很多项目做不下去,往往不是技术卡住,而是范围一直在膨胀。

技术选型:原生框架加云开发

我对比了三种常见路线:原生小程序框架、跨端框架、以及带云能力的方案。最终选择原生框架 + 云开发,原因很实际:

  • 不需要自己买服务器、配域名、走备案,个人项目省掉大量运维成本
  • 云数据库和云函数与小程序账号天然打通,登录态直接可用
  • 原生框架的调试工具链最完整,出问题容易定位

如果你的项目未来要同时上多个平台,跨端框架更合适;但如果目标就是微信生态内的轻量工具,原生方案的上手速度明显更快。

项目结构与页面拆分

我按功能把页面拆成三个主页面加一个组件:

miniprogram/
├── pages/
│   ├── index/        # 记账首页
│   ├── stats/        # 月度统计
│   └── mine/         # 个人中心
├── components/
│   └── category-picker/
├── utils/
│   └── format.js
└── app.js

页面数量少的时候,不要过早抽象。我的原则是:同一段逻辑出现第三次再抽成公共函数,组件只在真正复用时才建。

核心逻辑:一次记账的完整链路

记账的核心是「写入一条记录 + 更新本地缓存」。云数据库写入是异步的,但用户感知必须是即时的,所以我采用先更新本地、再异步同步的策略:

// pages/index/index.js
const db = wx.cloud.database()

Page({
  data: { amount: '', category: '餐饮', list: [] },

  onLoad() {
    this.loadLocal()
  },

  loadLocal() {
    const list = wx.getStorageSync('bills') || []
    this.setData({ list })
  },

  async save() {
    const { amount, category } = this.data
    if (!amount || Number(amount) <= 0) {
      wx.showToast({ title: '请输入有效金额', icon: 'none' })
      return
    }
    const record = {
      amount: Number(amount),
      category,
      createdAt: Date.now()
    }
    // 先落本地,界面立即响应
    const list = [record, ...this.data.list]
    wx.setStorageSync('bills', list)
    this.setData({ list, amount: '' })

    // 再异步同步到云端
    try {
      await db.collection('bills').add({ data: record })
    } catch (e) {
      wx.setStorageSync('pending', true)
    }
  }
})

这种「本地优先」的写法有两个好处:弱网环境下用户依然能记账;云端失败时也不会打断操作,后续可以在合适的时机补同步。

统计页的聚合计算

月度统计不需要频繁请求云端,直接在本地对列表做一次分组即可:

// pages/stats/stats.js
function groupByCategory(list) {
  const map = {}
  list.forEach(item => {
    map[item.category] = (map[item.category] || 0) + item.amount
  })
  const total = Object.values(map).reduce((a, b) => a + b, 0)
  return Object.keys(map).map(key => ({
    category: key,
    amount: map[key],
    percent: total ? Math.round((map[key] / total) * 100) : 0
  })).sort((a, b) => b.amount - a.amount)
}

数据量在几百条以内时,这种纯前端计算完全够用。等到记录上千条,再考虑把聚合放到云函数或加索引查询。

体验细节决定留存

功能跑通只是及格线,真正影响使用感受的是几个小地方:

  • 输入聚焦:进入首页自动聚焦金额输入框,减少一次点击
  • 默认分类:记住用户上次选择的分类,多数人消费场景是连续的
  • 空状态:没有记录时显示引导文案,而不是一片空白
  • 加载反馈:云同步时给一个轻量提示,避免用户以为没保存

这些改动加起来不到一百行代码,但对「愿不愿意第二天再打开」影响很大。

上线前要做的检查

提交审核之前,我按清单过了一遍:

  1. 基础库版本兼容,低版本做降级处理
  2. 所有云函数和数据库权限设置为「仅创建者可读写」
  3. 页面路径、分享卡片、隐私协议文案补齐
  4. 真机测试弱网与断网场景
  5. 体验版邀请几位朋友试用,收集一轮反馈再提审

审核被驳回最常见的原因是功能描述与实际不符,所以简介和截图要如实反映产品能力,不要为了吸引点击写夸大文案。

写在最后

制作小程序的门槛比很多人想象的低,真正的难点在于把范围控制住、把细节做扎实。一个只解决单一问题的小工具,只要链路顺畅,就比功能堆砌但处处卡顿的产品更有生命力。如果你也在酝酿自己的第一个小程序,建议从最小可用的版本开始,先让它跑起来,再逐步迭代。

从零搭建一个微信小程序的完整实践做个小程序到底要花多少钱?

评论 (0)

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

好想法,值得被认真交付

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

微信咨询

微信扫码,直接沟通需求