做微信小程序,最直接的路径是注册账号、装好开发者工具、写页面与逻辑、调试、提交审核。下面按实际开发顺序拆一遍,重点放在能跑通一个真实小程序的工程细节上。

一、账号与项目初始化
先到微信公众平台注册小程序账号,拿到 AppID。个人主体也能注册,但支付、部分类目能力受限,做商业项目要提前确认主体类型。接着下载微信开发者工具,新建项目时填入 AppID,选择不使用云开发或启用云开发。
项目结构大致如下:
├── app.js // 全局逻辑
├── app.json // 全局配置:页面路径、窗口、tabBar
├── app.wxss // 全局样式
├── pages/
│ └── index/
│ ├── index.js
│ ├── index.json
│ ├── index.wxml
│ └── index.wxss
└── project.config.json页面必须在 app.json 的 pages 数组里注册,否则无法访问。tabBar 最多 5 项,图标尺寸建议 81×81。
二、页面与数据绑定
WXML 负责结构,JS 负责数据与事件。一个列表页的典型写法:
// pages/list/list.js
Page({
data: { list: [], loading: true },
onLoad() {
this.fetchList()
},
async fetchList() {
const res = await wx.request({
url: 'https://api.example.com/items',
method: 'GET'
})
this.setData({ list: res.data, loading: false })
},
onTapItem(e) {
const id = e.currentTarget.dataset.id
wx.navigateTo({ url: `/pages/detail/detail?id=${id}` })
}
})<view wx:for="{{list}}" wx:key="id" bindtap="onTapItem" data-id="{{item.id}}">
<text>{{item.title}}</text>
</view>
<view wx:if="{{loading}}">加载中...</view>注意 setData 是异步的,且只传变化的数据能减少通信开销;列表渲染务必写 wx:key,否则更新时容易错位。
三、网络请求与登录态
小程序请求必须使用 HTTPS,且域名要在后台配置 request 合法域名。本地调试可在开发者工具里勾选“不校验合法域名”,但上线前必须配置。
登录流程通常是:前端调用 wx.login 拿 code,传给后端换取 openid,后端签发自己的 token 返回,前端存入 storage,后续请求带上。不要在前端直接存 openid 做身份凭证。
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)
}
})四、用云开发减少后端工作量
如果项目不大,云开发能省掉服务器和域名备案。开通后可直接用云数据库、云函数、云存储。一个云函数示例:
// cloudfunctions/getItems/index.js
const cloud = require('wx-server-sdk')
cloud.init()
const db = cloud.database()
exports.main = async () => {
const res = await db.collection('items').limit(20).get()
return { list: res.data }
}前端调用 wx.cloud.callFunction({ name: 'getItems' }) 即可。云开发的计费按资源用量,适合起步阶段,量大了要评估成本。
五、调试、审核与上线
- 用真机预览检查样式和交互,模拟器与真机存在差异。
- 在开发者工具“体验评分”里看性能问题,重点看首屏渲染和图片体积。
- 提交审核前完善类目、隐私协议、用户信息收集说明,涉及用户数据的接口要接隐私授权。
- 审核通过后点击发布,版本才会对线上用户生效。
上线后通过“运维中心”看错误日志,用 wx.reportMonitor 上报关键指标,比等用户反馈更快发现问题。
六、工程化建议
页面多了以后,把请求封装成统一模块,处理 token 过期和错误提示;公共组件抽到 components 目录;样式用 rpx 做适配,避免写死 px。构建体积控制在 2MB 主包以内,超出部分拆分包。
做到这一步,一个能上线、能迭代的微信小程序就成型了。后续的优化方向是首屏速度、接口缓存和埋点数据,这些都可以在现有结构上逐步加。

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