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

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

从零搭建一个微信小程序的完整实践

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

这次我用一个「记账小工具」从空目录走到能扫码体验的版本,把小程序搭建过程中真正需要动手的部分拆开讲清楚。技术栈选的是原生小程序 + 云开发,不引入第三方框架,适合个人开发者快速把想法跑起来。

从零搭建一个微信小程序的完整实践

一、项目初始化与目录约定

在微信开发者工具里新建项目,选择「不使用云服务」也可以,后面手动开通云开发。目录结构建议一开始就定好:

miniprogram/
  pages/
    index/
    add/
  components/
  utils/
  app.js
  app.json
  app.wxss
cloudfunctions/
  addRecord/
  listRecords/
project.config.json

app.json 里先只注册必要页面,页面多了再补,避免编译时出现大量未使用文件告警。

{
  "pages": ["pages/index/index", "pages/add/add"],
  "window": {
    "navigationBarTitleText": "随手记",
    "navigationBarBackgroundColor": "#ffffff"
  },
  "style": "v2",
  "sitemapLocation": "sitemap.json"
}

二、云开发环境与数据模型

开通云开发后拿到环境 ID,在 app.js 里初始化一次即可:

App({
  onLaunch() {
    if (!wx.cloud) {
      console.error('请使用 2.2.3 以上基础库')
      return
    }
    wx.cloud.init({
      env: 'your-env-id',
      traceUser: true
    })
  }
})

数据模型尽量扁平。记账记录只保留四个字段:amount(分,整数)、type(支出/收入)、remark、createTime。金额用整数分存储,能避开浮点误差,后面做统计也省事。

云函数负责写库,前端不直接操作数据库集合,权限和校验都收在服务端:

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

exports.main = async (event) => {
  const { amount, type, remark } = event
  if (!Number.isInteger(amount) || amount <= 0) {
    return { code: 400, msg: '金额不合法' }
  }
  const res = await db.collection('records').add({
    data: {
      amount,
      type: type === 'income' ? 'income' : 'expense',
      remark: String(remark || '').slice(0, 50),
      createTime: db.serverDate(),
      openid: cloud.getWXContext().OPENID
    }
  })
  return { code: 0, id: res._id }
}

三、页面交互与状态管理

首页只做两件事:拉列表、跳转新增。列表用 onShow 触发刷新,这样从新增页返回时数据是最新的,不需要额外的事件总线。

Page({
  data: { list: [], loading: true },
  onShow() {
    this.fetchList()
  },
  async fetchList() {
    this.setData({ loading: true })
    const { result } = await wx.cloud.callFunction({ name: 'listRecords' })
    this.setData({ list: result.data, loading: false })
  }
})

新增页把表单值转成分后调用云函数,成功后 wx.navigateBack() 回到首页,由 onShow 兜底刷新。这种「单向下发 + 页面回显」的方式在页面量少的项目里最省心。

四、性能与体验上的几个取舍

  • 列表首屏只取 20 条,滚动到底部再加载下一页,用 skip/limit 分页,避免一次拉全量。
  • 金额输入框设置 type="digit",并在提交前统一转整数分,前端只做提示不做强校验。
  • 云函数冷启动明显时,可以在首页 onLoad 里先发一次空请求预热,用户点新增时响应更快。
  • 图片、图标优先用本地小图或字体图标,减少网络请求数量。

五、上线前的检查清单

  1. 在小程序后台补齐服务类目,记账工具归入「工具-效率」类目更稳妥。
  2. 云开发数据库集合权限设为「仅创建者可读写」,配合云函数校验。
  3. 用真机预览走一遍新增、列表、空状态、网络异常四种路径。
  4. 提交审核前把测试数据清空,避免审核员看到脏数据。

整个搭建过程里,真正花时间的不是写页面,而是把数据模型和云函数边界想清楚。模型定得简单,后面加统计、加导出都只是新增云函数的事,前端改动很小。对个人开发者来说,先把最小闭环跑通,再往上叠功能,节奏会稳很多。

小程序商城从零到上线的完整路径从零制作一个小程序:我的完整开发手记

评论 (0)

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

好想法,值得被认真交付

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

微信咨询

微信扫码,直接沟通需求