小程序原生开发要点
原生小程序没有 DOM、没有浏览器历史,很多在 Web 里理所当然的能力需要换一种方式实现。
项目结构
pages/
index/
index.wxml
index.wxss
index.js
index.json
app.js
app.json
app.wxss
app.json:页面路径、窗口样式、tabBar、权限声明- 页面
.json:页面级配置,优先级高于全局 wxml:结构,只有小程序组件,没有 HTML 标签
数据与视图
小程序的视图更新依赖 setData:
Page({
data: {
list: [],
loading: false
},
onLoad() {
this.loadList()
},
async loadList() {
this.setData({ loading: true })
const list = await fetchList()
this.setData({ list, loading: false })
}
})
注意:
setData是跨线程通信,数据量越大成本越高- 只更新变化的部分,避免整个列表重新赋值
- 不要频繁调用
setData,合并多次更新
生命周期
onLoad:页面加载,适合取参数与初始化onShow/onHide:页面显示与隐藏onUnload:页面卸载,清理定时器与订阅onReachBottom:触底加载更多onPullDownRefresh:下拉刷新
常见限制
- 没有
window、document,第三方 Web 库不能直接用 - 包体积有限制,需要分包与按需加载
- 部分 CSS 能力受限,复杂动画优先用原生组件或 canvas
- 网络请求域名必须在后台配置白名单
- 本地存储有容量上限,不要存大对象
性能建议
- 长列表使用
recycle-view或分页加载 - 图片使用合适的尺寸,避免超大图
- 减少
setData的数据量与频率 - 分包预下载,提升二级页面打开速度
- 首屏只请求必要数据,其余延后加载
与 uniApp 的取舍
- 需要同时覆盖多端:优先 uniApp / Taro
- 只做微信小程序且依赖平台新能力:原生更直接
- 已有 Web 团队:跨端框架能显著降低迁移成本
- 对性能和包体极敏感:原生更容易做到极致