
文章分类:新闻资讯 发布时间:2026-11-18 原文作者:小程序开发 阅读( )

从零开始开发微信小程序,这份完整实战指南请收好。这话不是随便说说的。过去半年,我完整走了一遍从注册账号到上线审核的全流程,踩过的坑能装满一箩筐。今天把这些经验摊开来聊。小程序开发没想象中那么玄乎,但也绝不是拖拽几下就能搞定的事。关键是搞清楚每一步该干什么,别在无关紧要的地方浪费精力。
先搞定账号注册和工具准备。打开微信公众平台,点“立即注册”,选“小程序”类型。邮箱必须是没注册过公众号或小程序的,一个邮箱只能用一次。主体类型选企业还是个人,差别很大——个人号不能做支付、不能做直播,功能砍掉一大半。如果你打算正经做点事,建议直接上企业主体,营业执照拍照上传就行,审核一般两天内出结果。注册完拿到AppID,这东西相当于小程序的身份证,后面所有配置都要用到。开发工具去微信官方文档下载稳定版,别用beta版,坑多。装好后用管理员微信扫码登录,新建项目时填上AppID,选“不使用云开发”还是“使用云开发”看需求。云开发省去服务器搭建,适合新手快速跑通流程,但后期迁移成本高,自己权衡。
项目结构其实就四块东西。app.json管全局配置,页面路径、窗口样式、底部导航栏都在这写。app.js管生命周期,onLaunch里做初始化,onShow里处理切前台逻辑。app.wxss是全局样式表,相当于网页里的common.css。每个页面单独一个文件夹,里面放四个文件:js管逻辑,json管配置,wxml管结构,wxss管样式。别被这一堆文件吓到,实际写起来比Vue还简单。wxml里用view当div,text当span,image当img,数据绑定用{{}},列表渲染用wx:for,条件渲染用wx:if。事件绑定用bindtap,传参用data-开头的自定义属性。把这些搞明白,基本就能写出能跑的页面了。
样式和布局是新手最容易翻车的地方。小程序用rpx做单位,750rpx等于屏幕宽度,设计稿按750px宽做,标注多少就写多少rpx,省去换算烦恼。flex布局是绝对主力,display:flex一开,justify-content和align-items两行代码就能搞定大部分居中需求。但注意,小程序不支持通配符选择器,也不支持媒体查询里的某些语法。想适配不同屏幕,多用flex和百分比,少用固定px。导航栏分两种:全局导航在app.json里配,页面导航在页面json里配。想自定义导航栏就设navigationStyle为custom,然后自己写一个固定在顶部的view,记得处理刘海屏安全区域,padding-top用env(safe-area-inset-top)。
数据请求和接口调用绕不开这几个坑。wx.request发网络请求,域名必须提前在公众平台配置合法域名,本地开发时可以在开发者工具里勾选“不校验合法域名”临时绕过。但上线前一定要配好,不然正式版直接报错。请求默认超时60秒,建议手动设成10秒以内,用户体验更好。异步处理用async/await,记得在app.js里引入regenerator-runtime,否则低版本基础库报错。登录流程走wx.login拿code,传给后端换openid和session_key,别在前端存敏感信息。支付更复杂,需要商户号、证书、签名,建议后端全包,前端只调wx.requestPayment。还有,所有涉及用户信息的接口都要先调wx.getSetting检查授权,被拒后引导去设置页重新开启。
调试和优化决定小程序能不能留住人。开发者工具的调试器分五个面板:Wxml看结构,Console看日志,Sources看源码,Network看请求,AppData看数据。真机调试一定要用,模拟器上跑得欢,真机上白屏是常事。性能优化从三方面下手:图片压缩到100KB以内,用webp格式;setData只传变化的数据,别一股脑全量更新;长列表用虚拟滚动或分页加载,别一次渲染几百条。启动速度优化靠分包,把非首屏页面拆到subpackages里,主包控制在2MB以内。还有,onLoad里别做耗时操作,能放onReady就放onReady,能异步就异步。
审核上线是一道坎,也是最容易卡住的地方。提交审核前先自查:有没有诱导分享、有没有虚拟支付、有没有敏感词、类目对不对。个人号做工具类最容易过,做社交电商基本没戏。审核一般1到7天,被拒了别慌,看反馈改完重新提交。常见拒因:功能不完整、页面空白、诱导关注、资质缺失。上线后别以为就完了,每天看后台数据,留存率低于20%就要反思。版本更新走“开发版-体验版-审核版-线上版”流程,体验版加体验成员,让真实用户先跑一遍。记住,小程序不是做完就扔的项目,持续迭代比一次性开发重要得多。这份指南收好,剩下的靠你动手了。