小程序原生开发要点

原生小程序没有 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:下拉刷新

常见限制

  1. 没有 window、document,第三方 Web 库不能直接用
  2. 包体积有限制,需要分包与按需加载
  3. 部分 CSS 能力受限,复杂动画优先用原生组件或 canvas
  4. 网络请求域名必须在后台配置白名单
  5. 本地存储有容量上限,不要存大对象

性能建议

  • 长列表使用 recycle-view 或分页加载
  • 图片使用合适的尺寸,避免超大图
  • 减少 setData 的数据量与频率
  • 分包预下载,提升二级页面打开速度
  • 首屏只请求必要数据,其余延后加载

与 uniApp 的取舍

  • 需要同时覆盖多端:优先 uniApp / Taro
  • 只做微信小程序且依赖平台新能力:原生更直接
  • 已有 Web 团队:跨端框架能显著降低迁移成本
  • 对性能和包体极敏感:原生更容易做到极致