这个项目是一个面向本地生活服务的工具类小程序,核心功能是让用户按距离和分类查找附近的维修点,并支持收藏与分享。从立项到提交审核一共用了三周,下面按实际推进顺序记录关键决策和代码。

需求收敛与技术选型
需求最初列了十几个功能,最后只保留三条主线:列表检索、详情展示、收藏。判断标准很简单——没有它小程序就无法闭环的功能留下,其余全部放到第二版。这一步直接决定了工期可控。
技术栈上选择了微信小程序原生框架加云开发。理由有三个:
- 没有独立的服务端运维需求,云函数和云数据库足够支撑查询与写入;
- 用户身份直接使用 openid,省去登录体系;
- 地图、定位、分享等能力都是平台原生组件,接入成本低。
数据模型与云数据库设计
云数据库建了三张集合:shops 存维修点信息,favorites 存用户收藏关系,categories 存分类字典。查询以地理位置为主,因此 shops 中保存 location 地理坐标字段,并建立索引。
// shops 文档结构示例
{
_id: "shop_001",
name: "城东家电维修",
categoryId: "cat_02",
location: { type: "Point", coordinates: [114.52, 36.61] },
address: "XX路 12 号",
phone: "13800000000",
rating: 4.6
}
收藏关系用 openid + shopId 做唯一约束,避免重复写入。云函数里先查后写,配合数据库权限设置为“仅创建者可读写”,前端不直接操作集合。
核心页面实现
列表页的定位与检索
进入页面先调用 wx.getLocation 获取坐标,再请求云函数按距离排序返回附近数据。定位失败时降级为按城市默认坐标查询,保证页面不会空白。
Page({
data: { list: [], loading: true },
onLoad() {
this.fetchList();
},
async fetchList() {
try {
const { latitude, longitude } = await wx.getLocation({ type: 'gcj02' });
const res = await wx.cloud.callFunction({
name: 'getNearbyShops',
data: { latitude, longitude, categoryId: this.data.categoryId }
});
this.setData({ list: res.result.data, loading: false });
} catch (e) {
this.useFallbackCity();
}
}
})
详情页与收藏状态同步
详情页需要同时展示商家信息和当前用户的收藏状态。做法是在云函数中一次性返回两者,减少一次网络往返。收藏按钮点击后先本地切换 UI,再异步写库,失败时回滚并提示。
性能与体验优化
上线前做了一轮针对性优化,收益比较明显的有三点:
- 列表分页:每页 20 条,滚动到底部再加载,首屏渲染时间从约 900ms 降到 300ms 左右;
- 图片懒加载:列表缩略图使用
lazy-load,并统一走云存储的图片处理参数压缩尺寸; - 减少 setData 数据量:只更新变化的字段,避免整列表重设,滚动时掉帧明显减少。
经验是:小程序性能问题大多不是框架造成的,而是 setData 传了过多数据、图片没压缩、页面层级过深。先把这三点处理掉,再考虑更复杂的方案。
上线流程与后续计划
提交审核前补齐了隐私协议、用户信息收集说明,并确认所有网络请求域名都在白名单内。审核一次通过,用时约一天半。上线后通过云开发控制台观察调用量和错误日志,发现定位失败率偏高,补充了手动选择位置的入口。
第二版计划加入搜索联想和评价功能,同时把云函数中重复的权限校验逻辑抽成公共模块。整个开发实录说明一件事:把范围压小、把数据流理清,一个人也能在较短时间内交付一个可用的小程序。

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