小程序开发步骤：我踩过的坑都在这

每次有人问我「小程序开发到底分几步」，我都想说：步骤本身不复杂，复杂的是每一步里那些没人提前告诉你的细节。这篇不列教科书目录，按我自己接单、自己写代码的顺序，把真实流程和踩过的坑摊开讲。

第一步：先想清楚「不做会怎样」

很多人一上来就画原型、选框架，我建议先停一下。问自己三个问题：

• 用户为什么不用公众号、H5 或直接打电话，非得打开小程序？
• 核心功能能不能用一句话说清？说不清就说明还没想明白。
• 第一版最少要几个页面？超过 8 个，大概率是需求膨胀了。

我见过太多项目死在「功能太多」上。第一版能跑通一条主流程，比堆十个半成品功能值钱得多。

第二步：账号和资质，别等写完代码才办

这一步最枯燥，但最容易卡进度。去微信公众平台注册小程序账号，个人主体和公司主体能做的事差别很大：支付、部分类目、直播组件，个人号基本用不了。如果涉及电商、医疗、教育这些类目，还要提前准备资质材料，审核周期说不准。

我的习惯：立项第一天就把账号注册、类目选择、服务器域名备案这几件事并行推进，代码可以后写，审核不等人。

另外，服务器域名必须备案并配置到「request 合法域名」里，本地开发用开发者工具勾选「不校验合法域名」能跑，但真机预览时经常忘了这茬，白折腾半天。

第三步：技术选型，别为了时髦给自己挖坑

现在选择无非几种：原生小程序、uni-app、Taro，再加上云开发还是自建后端。

• 原生：性能最好，官方文档最全，适合只做微信一端、对体验要求高的项目。
• uni-app / Taro：要同时出 App 或 H5 时省事，但遇到平台差异时调试成本会上来。
• 云开发：小团队、快速验证阶段很香，数据库、存储、云函数一把梭，省掉服务器运维。

我个人的判断标准很简单：如果三个月内要上线、团队就一两个人，云开发优先；如果后面要接复杂业务、要和其他系统打通，老老实实自建后端，别为了省事前中期舒服、后期迁移痛苦。

第四步：搭骨架，先把页面流转跑通

别急着写业务逻辑。先建好目录结构，把 tabBar、页面路由、公共组件（按钮、弹窗、空状态）搭起来，用假数据把主流程点一遍。这一步做完，你才知道哪些页面是多余的。

// app.json 里先把页面和 tabBar 定下来
{
  "pages": [
    "pages/index/index",
    "pages/detail/detail",
    "pages/mine/mine"
  ],
  "tabBar": {
    "list": [
      { "pagePath": "pages/index/index", "text": "首页" },
      { "pagePath": "pages/mine/mine", "text": "我的" }
    ]
  }
}

骨架阶段就把 loading、错误提示、空数据这三种状态考虑进去，后面能少返工一大截。

第五步：接口联调，约定比技术重要

前后端分离的项目，联调吵架多半是因为字段命名和状态码没提前说好。我的做法是：先把接口文档写出来，字段名、类型、分页参数、错误码统一，再各自开工。小程序端封装一个统一的请求方法，把 token、超时、错误提示都收口，别在每个页面里重复写 wx.request。

const request = (url, data = {}, method = 'GET') => {
  return new Promise((resolve, reject) => {
    wx.request({
      url: baseUrl + url,
      data,
      method,
      timeout: 10000,
      success: res => {
        if (res.statusCode === 200 && res.data.code === 0) {
          resolve(res.data.data)
        } else {
          wx.showToast({ title: res.data.msg || '请求失败', icon: 'none' })
          reject(res.data)
        }
      },
      fail: reject
    })
  })
}

第六步：真机测试和性能自查

开发者工具里跑得顺，不代表真机没问题。重点看几件事：

• 首屏加载时间，图片有没有压缩、有没有懒加载；
• setData 的数据量，列表页一次塞几百条数据，页面必卡；
• 低端安卓机上的滚动和动画表现；
• 授权、支付、分享这些依赖微信能力的流程，必须真机走一遍。

性能这块不用一上来就死磕，但明显的问题（大图、频繁 setData、长列表不分页）上线前一定要处理，否则用户第一印象就没了。

第七步：提审上线，留出缓冲期

提交审核前检查清单：类目是否匹配、隐私协议有没有配、有没有诱导分享或诱导关注的内容、测试账号是否填好。审核被驳回很常见，理由往往很具体，按提示改就行，别硬刚。

上线也不是终点。发布后盯着后台的访问、错误日志和用户反馈，前两周往往能暴露一批测试没覆盖到的问题。版本迭代时记得保留回滚方案，别一次改太多。

最后说两句

小程序开发的步骤，说白了就是：想清楚、办资质、选技术、搭骨架、联调、测真机、提审上线。真正拉开差距的不是你知道这几步，而是每一步有没有提前想到后面的坑。如果你是找人外包，也建议拿这份流程去对一下对方的排期，能问出不少东西。