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

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

微信小程序从零到发布:我的技术实践

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

做了几年独立开发,微信小程序一直是我最常交付的形态:用户不必安装,入口就在聊天列表里,运营侧还能通过订阅消息和客服消息做二次触达。这篇文章不聊概念,只复盘一个真实项目的技术路径——从项目初始化到提交审核,把每个环节里我认为值得写下来的决策和代码放出来。

微信小程序从零到发布:我的技术实践

一、项目初始化与目录约定

我习惯用原生框架起步,不引入跨端方案。原因很直接:小体量项目里,跨端带来的构建层和运行时开销,往往比它省下的工作量更大。初始化后先固定目录结构:

miniprogram/
  pages/          # 页面,按业务域分子目录
  components/     # 通用组件
  utils/          # request、format、storage 等纯函数
  services/       # 业务接口封装
  app.js
  app.json
  app.wxss

页面只负责渲染和事件转发,数据请求统一走 services,工具函数保持无副作用。这个约定在后期加需求时能省很多返工。

二、请求层:把重复逻辑收口

原生 wx.request 是回调风格,直接散落在页面里会很快失控。我的做法是封装一层 Promise,并统一处理登录态、错误提示和超时:

// utils/request.js
const BASE_URL = 'https://api.example.com'

function request(path, options = {}) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: BASE_URL + path,
      method: options.method || 'GET',
      data: options.data || {},
      header: {
        'content-type': 'application/json',
        'Authorization': wx.getStorageSync('token') || ''
      },
      timeout: 10000,
      success(res) {
        if (res.statusCode === 200 && res.data.code === 0) {
          resolve(res.data.data)
        } else if (res.statusCode === 401) {
          wx.removeStorageSync('token')
          wx.reLaunch({ url: '/pages/login/index' })
          reject(new Error('unauthorized'))
        } else {
          wx.showToast({ title: res.data.msg || '请求失败', icon: 'none' })
          reject(new Error(res.data.msg || 'request failed'))
        }
      },
      fail(err) {
        wx.showToast({ title: '网络异常', icon: 'none' })
        reject(err)
      }
    })
  })
}

module.exports = { request }

这样页面里只剩一行 await request('/order/list'),错误提示和登录失效的跳转都集中在一处,改一次全局生效。

三、登录态:code 换 token 的最小闭环

小程序登录的核心是 wx.login 拿到临时 code,交给自己的服务端换 openid 并签发 token。前端不要试图自己解析用户身份,也不要在本地长期保存敏感信息。

// services/auth.js
const { request } = require('../utils/request')

function login() {
  return new Promise((resolve, reject) => {
    wx.login({
      success: async ({ code }) => {
        try {
          const data = await request('/auth/login', {
            method: 'POST',
            data: { code }
          })
          wx.setStorageSync('token', data.token)
          resolve(data.user)
        } catch (e) {
          reject(e)
        }
      },
      fail: reject
    })
  })
}

token 的有效期设短一些,配合服务端刷新逻辑;本地只存 token 和必要的展示字段。

四、云开发适合什么场景

如果项目没有独立后端团队,云开发的性价比很高:云函数承载业务逻辑,云数据库存业务数据,云存储放图片。我的判断标准是——数据模型简单、并发量中等、团队只有一到两人,就值得用云开发。

一个典型的云函数写法:

// cloudfunctions/getOrders/index.js
const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })
const db = cloud.database()

exports.main = async (event) => {
  const { OPENID } = cloud.getWXContext()
  const res = await db.collection('orders')
    .where({ openid: OPENID })
    .orderBy('createdAt', 'desc')
    .limit(20)
    .get()
  return { code: 0, data: res.data }
}

注意云函数里直接用 getWXContext() 取 openid,不要信任前端传来的用户标识,这是权限设计的基本前提。

五、性能与体验的几个抓手

  • 首屏体积:图片走 CDN 并压缩,图标优先用字体或内联 SVG,减少包体。
  • 分包加载:非首屏页面拆到分包,主包控制在 2MB 以内,启动更快。
  • setData 粒度:只更新变化的字段,避免整对象回写,列表页尤其明显。
  • 骨架屏:列表首屏用静态骨架占位,弱网下体感提升很大。
  • 缓存策略:配置类数据用 wx.setStorageSync 加时间戳缓存,减少重复请求。

六、提审前要自查的清单

  1. 所有页面在真机上跑一遍,重点看 iOS 与 Android 的样式差异。
  2. 检查 app.json 里的页面路径、tabBar 配置与实际文件一致。
  3. 确认没有未声明的接口域名,服务端域名已在小程序后台配置。
  4. 用户信息、手机号等敏感能力只在必要时申请,并写明用途。
  5. 隐私政策与用户协议页面可访问,且内容与功能匹配。
  6. 提交前用体验版走一遍完整主流程,包括支付、退款、消息通知等分支。

七、上线之后

小程序发布不是终点。上线后第一周我会盯三件事:启动耗时、接口错误率、核心流程的转化漏斗。数据埋点不必复杂,关键节点打点即可,比如进入首页、点击下单、支付成功。有了这组数据,后续迭代才有依据,而不是凭感觉改版。

对独立开发者来说,微信小程序的价值在于交付链路短、维护成本可控。把请求层、登录态、云函数这几块基础打牢,后面接新需求就是拼装,而不是重写。

微信小程序从零到上线的完整路径从零构建微信小程序的完整实践

评论 (0)

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

好想法,值得被认真交付

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

微信咨询

微信扫码,直接沟通需求