做了三年多小程序,交付过电商、预约、工具类共十几个项目。回头看,真正拉开项目质量差距的往往不是功能多少,而是工程习惯。这篇记录我在实际项目中沉淀下来的经验,适合已经能跑通 Hello World、准备做真实项目的开发者。

一、先把页面结构定下来,再写业务
小程序页面天然是「一页一职责」,但很多人习惯把所有逻辑塞进 onLoad,结果页面越写越重。我的做法是固定三层:
- 页面层:只负责生命周期、参数解析、调用 service、把数据交给视图。
- service 层:封装请求、缓存、数据整形,不依赖页面实例。
- 组件层:把可复用的列表项、弹窗、空状态抽成自定义组件。
这样做的直接收益是调试成本下降。页面出问题时,先判断是数据没来(service 层)还是渲染没更新(页面层),排查路径清晰很多。
二、setData 是性能分水岭
小程序的逻辑层和渲染层是分离的,每次 setData 都要跨线程通信。项目做大后,卡顿八成来自这里。几条实践:
- 只传变化字段,用路径写法,例如
this.setData({'list[3].status': 1}),不要整份 list 重设。 - 列表分页追加时,用
concat生成新数组一次提交,避免循环内多次 setData。 - 与渲染无关的数据(定时器 id、请求标记、原始响应)挂在
this上,不要放进 data。 - 高频事件(滚动、输入)做节流,输入框用
bindinput时不要每次按键都触发网络请求。
// 不推荐:整表覆盖
this.setData({ list: newList });
// 推荐:只更新单条
this.setData({ [`list[${index}].status`]: 1 });
三、请求层要统一收口
项目里最容易被复制粘贴污染的就是 wx.request。我的习惯是写一个 request.js,统一处理 baseURL、token 注入、错误码、loading 和超时:
function request({ url, method = 'GET', data = {}, loading = true }) {
if (loading) wx.showLoading({ title: '加载中', mask: true });
return new Promise((resolve, reject) => {
wx.request({
url: BASE_URL + url,
method,
data,
header: { Authorization: wx.getStorageSync('token') || '' },
timeout: 10000,
success(res) {
if (res.statusCode === 200 && res.data.code === 0) {
resolve(res.data.data);
} else if (res.data.code === 401) {
wx.reLaunch({ url: '/pages/login/index' });
reject(res.data);
} else {
wx.showToast({ title: res.data.msg || '请求失败', icon: 'none' });
reject(res.data);
}
},
fail(err) {
wx.showToast({ title: '网络异常', icon: 'none' });
reject(err);
},
complete() {
if (loading) wx.hideLoading();
}
});
});
}
统一收口后,换域名、加签名、改错误提示都只动一个文件,也方便后续接入云开发或自建网关。
四、云开发适合什么场景
用云开发做过两个中小型项目,结论是:没有后端团队、数据模型简单、并发不高的项目非常适合。数据库、存储、云函数一站式解决,省掉服务器和备案环节。但要注意几点:
- 云函数冷启动明显,首屏依赖的接口尽量放前端直连数据库,或做预热。
- 数据库权限规则要在控制台配好,别默认「所有用户可读」。
- 复杂聚合查询和事务能力有限,业务一旦变重,迁移成本要考虑进去。
五、上线前的固定检查清单
每次提审前我都会过一遍:
- 体验版真机走完主流程,重点测弱网和断网重连。
- 检查所有
navigateTo层级是否超过 10 层,改用redirectTo。 - 图片走 CDN 并压缩,首屏大图不超过 200KB。
- 隐私协议、用户信息授权、类目资质是否齐全,这是审核驳回的高发区。
- 分包配置:主包控制在 2MB 内,非首屏页面全部拆到分包。
六、关于协作与交付
如果是接外包或与客户协作,需求文档里一定要写清楚「改几次、改什么范围」。小程序迭代快,但代码质量靠的是克制:能抽组件的别复制,能写注释的别省,版本号按语义化走。交付时附一份环境配置说明和数据库结构说明,后续维护会轻松很多。
小程序本身不难,难的是长期维护时的整洁度。把 setData、请求层、分包这三件事做扎实,大部分性能和协作问题都能提前消掉。

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