专注小程序 / APP 开发,用代码改变生活

获取方案
全国分站 主站首页 北京分站 石家庄分站 唐山分站 保定分站 廊坊分站 沧州分站 郑州分站 邯郸分站

从零构建微信小程序的完整实践

小程序开发 2026-11-11 7 阅读 0 点赞 原创

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

从零构建微信小程序的完整实践

一、账号与项目初始化

先到微信公众平台注册小程序账号,拿到 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)

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

好想法,值得被认真交付

从小程序、APP 到全栈网站,一站式把想法变成可落地的产品

微信咨询

微信扫码,直接沟通需求