做一个微信小程序,从注册账号到提交审核上线,中间要经过环境搭建、页面开发、接口联调、体验版验证、审核发布几个阶段。这篇文章按实际动手顺序,把每个阶段需要做的事和容易卡住的地方讲清楚,适合已经会一点 JavaScript、准备独立完成第一个小程序的开发者。

一、账号与开发环境准备
先到微信公众平台注册小程序账号,拿到 AppID。这一步决定了后面能不能用云开发、能不能调起支付。个人主体可以注册,但支付、部分类目能力受限,如果项目涉及交易,最好一开始就用企业主体。
工具层面只需要两样:微信开发者工具和一个代码编辑器。开发者工具自带模拟器、调试器、真机预览,日常开发基本够用。新建项目时选择目录、填入 AppID,模板选“不使用云服务”或“云开发”都可以,后者会自动生成云函数目录结构。
- 项目配置文件
project.config.json建议纳入版本管理,团队协作时保持编译设置一致。 - 在“详情-本地设置”里打开“不校验合法域名”,否则本地请求接口会被拦截。
- 真机预览用手机扫码,调试基础库版本尽量与线上用户的主流版本对齐。
二、目录结构与页面组织
小程序采用页面级路由,每个页面由 .wxml、.wxss、.js、.json 四个文件组成。项目变大后,建议按业务域划分目录,公共组件放 components,工具函数放 utils,请求封装单独一层。
miniprogram/
pages/
index/
detail/
components/
card/
utils/
request.js
app.js
app.json
app.json 里集中声明页面路径、窗口样式和 tabBar。页面数量多时注意首个页面是启动页,路径写错会直接白屏。tabBar 的图标需要本地图片,且大小控制在 40KB 以内。
三、数据请求与状态管理
小程序的网络请求用 wx.request,不支持浏览器那套 fetch。实际项目里通常封装一层,统一处理域名、请求头、错误码和登录态。
const BASE = 'https://api.example.com';
function request(path, options = {}) {
return new Promise((resolve, reject) => {
wx.request({
url: BASE + path,
method: options.method || 'GET',
data: options.data || {},
header: {
'content-type': 'application/json',
Authorization: wx.getStorageSync('token') || ''
},
success(res) {
if (res.statusCode === 200 && res.data.code === 0) {
resolve(res.data.data);
} else {
reject(res.data);
}
},
fail: reject
});
});
}
module.exports = { request };
状态管理方面,页面少的时候直接用 setData 就够了;跨页面共享的数据可以放在 app.globalData 或 getApp() 上。页面超过十来个、状态互相依赖时,再考虑引入轻量状态库,不必一上来就上框架。
需要注意 setData 是跨线程通信,一次传的数据越大越慢。列表渲染时只更新变化的字段,避免把整个大数组反复塞进去。
四、云开发能省掉哪些工作
如果项目没有复杂的后端逻辑,云开发是很实际的选择。它提供数据库、云函数、云存储和静态托管,省去服务器采购、域名备案、HTTPS 证书配置这一整套流程。
- 数据库是文档型,读写通过
wx.cloud.database(),权限规则在控制台配置,前端能直接读写的数据要谨慎开放。 - 云函数适合放敏感逻辑,比如下单、支付回调、定时任务。写完在开发者工具里右键上传部署即可。
- 云存储用来放图片和文件,返回的 fileID 可以直接在
image组件里使用。
云开发的计费按资源用量走,早期免费额度对个人项目基本够用。但数据库查询有单次返回条数限制,列表分页要自己处理 skip 和 limit。
五、真机验证与上线审核
模拟器跑通不代表真机没问题。上传体验版之前,至少要在 iOS 和 Android 各一台真机上过一遍主流程,重点看滚动、键盘弹起、图片加载和授权弹窗。
提交审核前检查这几项:
- 服务类目与实际功能一致,类目选错是审核驳回的常见原因。
- 涉及用户信息的接口要有隐私协议弹窗,并在后台配置隐私保护指引。
- 页面里不能出现测试数据、调试入口和明显的占位文案。
- 版本描述写清楚本次更新内容,方便审核人员理解。
审核通过后点击发布,用户端才会更新。发布后建议观察一两天的基础数据,包括启动次数、页面停留和错误日志,开发者工具里的“运维中心”可以看到线上 JS 错误。
六、后续迭代的节奏
小程序上线只是起点。后续迭代建议保持小步快跑:每次只改一两个功能点,体验版验证后尽快提审,避免攒一个大版本一次发布。功能增长后,把公共逻辑抽成组件和工具函数,页面文件控制在两三百行以内,维护成本会低很多。
性能上优先关注首屏:减少启动时的同步请求,图片用 CDN 并压缩尺寸,非首屏内容延后加载。这些改动投入不大,但对留存的影响很直接。

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