做一个微信小程序,本质上就是完成三件事:把需求拆成可开发的页面与数据模型,用微信提供的能力把交互和数据跑通,最后提交审核并发布上线。下面按实际开发顺序展开,给出一套可以直接照着走的流程。

一、开发前先把三件事定下来
很多项目返工,不是代码写错,而是开工前没想清楚。开始写第一行代码之前,先确定:
- 核心功能清单:只保留一条主链路,例如“浏览商品—下单—支付—查看订单”,其余功能放到第二版。
- 账号与主体:小程序需要在微信公众平台注册,个人主体不能开通支付、不能做部分类目,涉及交易要提前准备企业主体和营业执照。
- 数据放在哪:自建服务器,还是用微信云开发。前者灵活但需要备案、运维;后者免运维,适合独立开发者和小团队快速验证。
二、搭建项目骨架
在微信开发者工具中新建项目,填入 AppID,选择不使用云服务或云开发模板。项目结构大致如下:
miniprogram/
app.js 全局逻辑
app.json 全局配置(页面路径、窗口样式、tabBar)
app.wxss 全局样式
pages/
index/ 首页
detail/ 详情页
mine/ 个人中心
utils/ 工具函数
components/ 自定义组件页面必须在 app.json 的 pages 数组里注册,数组第一项就是启动页。tabBar 最多 5 个,图标需要本地图片,不支持网络地址。
三、页面开发的基本套路
每个页面由 wxml、wxss、js、json 四个文件组成。wxml 负责结构,用数据绑定和列表渲染替代 DOM 操作:
<view class="list">
<view class="item" wx:for="{{goods}}" wx:key="id" bindtap="goDetail" data-id="{{item.id}}">
<image src="{{item.cover}}" mode="aspectFill" />
<text>{{item.title}}</text>
</view>
</view>js 里通过 setData 更新视图,注意只传变化的字段,整对象刷新会带来不必要的渲染开销:
Page({
data: { goods: [] },
onLoad() {
this.loadGoods()
},
async loadGoods() {
const res = await wx.request({ url: 'https://api.example.com/goods' })
this.setData({ goods: res.data.list })
},
goDetail(e) {
const id = e.currentTarget.dataset.id
wx.navigateTo({ url: `/pages/detail/detail?id=${id}` })
}
})页面间传参用 URL query,返回上一页用 wx.navigateBack。tabBar 页面之间跳转必须用 wx.switchTab,这是新手最常卡住的地方。
四、接口请求与登录态
小程序不允许直接跨域请求任意域名,必须在小程序后台配置 request 合法域名,且必须是 HTTPS。登录流程通常是:
- 前端调用
wx.login拿到临时 code; - 把 code 发给自己的后端,后端调用微信接口换取 openid 和 session_key;
- 后端生成自定义登录态(如 token)返回前端,前端存入 storage,后续请求带上。
wx.login({
success: async ({ code }) => {
const res = await wx.request({
url: 'https://api.example.com/login',
method: 'POST',
data: { code }
})
wx.setStorageSync('token', res.data.token)
}
})不要在客户端保存 session_key,也不要把 AppSecret 写进小程序代码,这两个东西一旦泄露就是安全事故。
五、用云开发省掉服务器
如果项目只有增删改查和少量图片存储,云开发能显著缩短周期。初始化后可以直接调用数据库和云函数:
// app.js
App({
onLaunch() {
wx.cloud.init({ env: 'your-env-id', traceUser: true })
}
})
// 页面中查询
const db = wx.cloud.database()
const { data } = await db.collection('goods').where({ onSale: true }).get()云开发的权限规则在控制台配置,默认“仅创建者可读写”,做公开数据时要改成“所有用户可读”。图片上传用 wx.cloud.uploadFile,返回 fileID 直接存库。
六、提交审核与发布
开发完成后,在开发者工具点击上传,填写版本号和备注,然后到公众平台提交审核。审核前需要确认:
- 类目与实际功能一致,选了不匹配的类目会被驳回;
- 涉及用户信息的页面要有隐私政策说明;
- 测试账号或体验路径写清楚,方便审核人员操作;
- 页面不能有空白页、死链和明显的测试数据。
审核通过后点击发布,可选择全量发布或分阶段发布。发布后通过“体验版”和“线上版”对照验证,确认接口域名、支付回调都指向生产环境。
七、上线后的持续维护
小程序不是发完就结束。建议接入实时日志或自建埋点,关注页面停留、接口失败率;用 wx.getUpdateManager 处理版本更新提示;定期检查基础库兼容性,新能力上线前先在体验版验证。把每次迭代控制在可回滚的范围内,比一次性堆功能更稳。
整体来看,一个功能明确的小程序,从注册到上线通常在两到四周内可以完成。真正决定成败的不是框架多新,而是需求边界是否清晰、数据链路是否闭环。

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