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

一、项目初始化与目录约定
在微信开发者工具里新建项目,选择「不使用云服务」也可以,后面手动开通云开发。目录结构建议一开始就定好:
miniprogram/
pages/
index/
add/
components/
utils/
app.js
app.json
app.wxss
cloudfunctions/
addRecord/
listRecords/
project.config.jsonapp.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里先发一次空请求预热,用户点新增时响应更快。 - 图片、图标优先用本地小图或字体图标,减少网络请求数量。
五、上线前的检查清单
- 在小程序后台补齐服务类目,记账工具归入「工具-效率」类目更稳妥。
- 云开发数据库集合权限设为「仅创建者可读写」,配合云函数校验。
- 用真机预览走一遍新增、列表、空状态、网络异常四种路径。
- 提交审核前把测试数据清空,避免审核员看到脏数据。
整个搭建过程里,真正花时间的不是写页面,而是把数据模型和云函数边界想清楚。模型定得简单,后面加统计、加导出都只是新增云函数的事,前端改动很小。对个人开发者来说,先把最小闭环跑通,再往上叠功能,节奏会稳很多。

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