做了几年独立开发,微信小程序一直是我最常交付的形态:用户不必安装,入口就在聊天列表里,运营侧还能通过订阅消息和客服消息做二次触达。这篇文章不聊概念,只复盘一个真实项目的技术路径——从项目初始化到提交审核,把每个环节里我认为值得写下来的决策和代码放出来。

一、项目初始化与目录约定
我习惯用原生框架起步,不引入跨端方案。原因很直接:小体量项目里,跨端带来的构建层和运行时开销,往往比它省下的工作量更大。初始化后先固定目录结构:
miniprogram/
pages/ # 页面,按业务域分子目录
components/ # 通用组件
utils/ # request、format、storage 等纯函数
services/ # 业务接口封装
app.js
app.json
app.wxss
页面只负责渲染和事件转发,数据请求统一走 services,工具函数保持无副作用。这个约定在后期加需求时能省很多返工。
二、请求层:把重复逻辑收口
原生 wx.request 是回调风格,直接散落在页面里会很快失控。我的做法是封装一层 Promise,并统一处理登录态、错误提示和超时:
// utils/request.js
const BASE_URL = 'https://api.example.com'
function request(path, options = {}) {
return new Promise((resolve, reject) => {
wx.request({
url: BASE_URL + path,
method: options.method || 'GET',
data: options.data || {},
header: {
'content-type': 'application/json',
'Authorization': wx.getStorageSync('token') || ''
},
timeout: 10000,
success(res) {
if (res.statusCode === 200 && res.data.code === 0) {
resolve(res.data.data)
} else if (res.statusCode === 401) {
wx.removeStorageSync('token')
wx.reLaunch({ url: '/pages/login/index' })
reject(new Error('unauthorized'))
} else {
wx.showToast({ title: res.data.msg || '请求失败', icon: 'none' })
reject(new Error(res.data.msg || 'request failed'))
}
},
fail(err) {
wx.showToast({ title: '网络异常', icon: 'none' })
reject(err)
}
})
})
}
module.exports = { request }
这样页面里只剩一行 await request('/order/list'),错误提示和登录失效的跳转都集中在一处,改一次全局生效。
三、登录态:code 换 token 的最小闭环
小程序登录的核心是 wx.login 拿到临时 code,交给自己的服务端换 openid 并签发 token。前端不要试图自己解析用户身份,也不要在本地长期保存敏感信息。
// services/auth.js
const { request } = require('../utils/request')
function login() {
return new Promise((resolve, reject) => {
wx.login({
success: async ({ code }) => {
try {
const data = await request('/auth/login', {
method: 'POST',
data: { code }
})
wx.setStorageSync('token', data.token)
resolve(data.user)
} catch (e) {
reject(e)
}
},
fail: reject
})
})
}
token 的有效期设短一些,配合服务端刷新逻辑;本地只存 token 和必要的展示字段。
四、云开发适合什么场景
如果项目没有独立后端团队,云开发的性价比很高:云函数承载业务逻辑,云数据库存业务数据,云存储放图片。我的判断标准是——数据模型简单、并发量中等、团队只有一到两人,就值得用云开发。
一个典型的云函数写法:
// cloudfunctions/getOrders/index.js
const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })
const db = cloud.database()
exports.main = async (event) => {
const { OPENID } = cloud.getWXContext()
const res = await db.collection('orders')
.where({ openid: OPENID })
.orderBy('createdAt', 'desc')
.limit(20)
.get()
return { code: 0, data: res.data }
}
注意云函数里直接用 getWXContext() 取 openid,不要信任前端传来的用户标识,这是权限设计的基本前提。
五、性能与体验的几个抓手
- 首屏体积:图片走 CDN 并压缩,图标优先用字体或内联 SVG,减少包体。
- 分包加载:非首屏页面拆到分包,主包控制在 2MB 以内,启动更快。
- setData 粒度:只更新变化的字段,避免整对象回写,列表页尤其明显。
- 骨架屏:列表首屏用静态骨架占位,弱网下体感提升很大。
- 缓存策略:配置类数据用
wx.setStorageSync加时间戳缓存,减少重复请求。
六、提审前要自查的清单
- 所有页面在真机上跑一遍,重点看 iOS 与 Android 的样式差异。
- 检查
app.json里的页面路径、tabBar 配置与实际文件一致。 - 确认没有未声明的接口域名,服务端域名已在小程序后台配置。
- 用户信息、手机号等敏感能力只在必要时申请,并写明用途。
- 隐私政策与用户协议页面可访问,且内容与功能匹配。
- 提交前用体验版走一遍完整主流程,包括支付、退款、消息通知等分支。
七、上线之后
小程序发布不是终点。上线后第一周我会盯三件事:启动耗时、接口错误率、核心流程的转化漏斗。数据埋点不必复杂,关键节点打点即可,比如进入首页、点击下单、支付成功。有了这组数据,后续迭代才有依据,而不是凭感觉改版。
对独立开发者来说,微信小程序的价值在于交付链路短、维护成本可控。把请求层、登录态、云函数这几块基础打牢,后面接新需求就是拼装,而不是重写。

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