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

打开微信,点开任何一个小程序,你可能觉得这玩意儿挺神秘。但真上手做,你会发现它比你想象中简单,也比你想象中麻烦。简单在于工具链成熟,麻烦在于流程琐碎。这篇文章不跟你扯虚的,就按我踩过的坑,一步步讲清楚个人开发者从零开始到底怎么搞。
先说注册账号。别急着写代码,先得有个“身份证”。打开微信公众平台,选“小程序”,点“立即注册”。这里有个关键选择:主体类型选“个人”。别选企业,那需要营业执照和对公账户,个人开发者用不着。填邮箱,注意这个邮箱没注册过公众号或小程序,不然会冲突。激活邮件后,接下来就是完善信息。个人主体需要管理员扫码绑定,一个身份证和手机号只能绑定五个小程序,这个额度得记清楚。注册完成后,你会拿到一个AppID,这玩意儿就是个门牌号,后续开发工具里要填。
接下来是下载开发者工具。百度搜“微信开发者工具”,官网下载稳定版就行。装好之后,打开扫码登录,新建项目。这里有个坑:项目名称随便起,但目录别放C盘,后面编译缓存占空间。选择“小程序”模板,后端服务选“不使用云服务”,除非你打算用云开发,那个后面再说。填上刚才的AppID,点确定,就会生成一个默认的Hello World项目。这时候你看到的界面,左边是模拟器,右边是代码区,下面有编译和调试面板。先别急着改代码,点一下“编译”按钮,看到模拟器里出现“Hello World”文字,说明环境通了。
现在正式进入代码阶段。小程序的目录结构固定:app.js是入口逻辑,app.json是全局配置,app.wxss是全局样式。pages文件夹放页面,每个页面有四个文件:wxml(结构)、wxss(样式)、js(逻辑)、json(配置)。新手最容易犯的错是改完代码不保存就编译,或者改了js忘了改wxml,页面报错半天找不着原因。我建议你先别动默认代码,把app.json里的pages数组改成你自己的页面路径,比如“pages/index”,然后删掉默认的index和logs,重新建一个空白页面。这个过程会让你理解页面注册的逻辑。
页面搭建是重点。wxml类似HTML,但标签是view、text、button这些。wxss就是CSS,只是单位用rpx,不用px。rpx是微信的响应式单位,屏幕宽度固定750rpx,这样在不同手机上显示比例一致。写代码时有个技巧:把模拟器调到iPhone X的尺寸,因为那是最窄的屏,能适配它就能适配大多数机型。布局用flex,简单直观。新手别一上来就搞复杂动画,先把基础的view嵌套、text展示、button点击事件跑通。js文件里,Page函数接收一个对象,data里放数据,bindtap绑定事件,setData更新界面。记住,所有数据变化必须走setData,直接改data不会刷新页面。
调试是家常便饭。模拟器里右键可以检查元素,Console面板看报错,Network面板看请求。最烦的是真机预览和模拟器表现不一致,比如字体大小、滑动流畅度。这时候别慌,点工具栏的“预览”按钮,会生成一个二维码,手机上扫码就能看真机效果。要是手机上白屏,大概率是域名没配或HTTPS证书有问题。个人开发者没有企业认证,很多API用不了,比如支付、附近的小程序,但基础的分享、定位、扫码还是可以的。调试时多留意控制台的警告信息,很多坑其实微信都提示了,只是你懒得看。
发布上线是一步,也是最容易被忽视的一步。点击工具栏的“上传”按钮,填写版本号和备注,然后去微信公众平台的后台,找到“版本管理”,在开发版本里找到你刚上传的版本,点“提交审核”。审核一般一两天,快的话几小时。审核期间别闲着,把“用户隐私保护指引”填了,不然审核会被打回。审核通过后,点“发布”,小程序就正式上线了。但别高兴太早,上线后还要设置“服务器域名”,如果你用了自己的后端接口,必须在后台配置合法域名,不然真机请求会被拦截。
说几个我踩过的坑,帮你避雷。第一,个人开发者不能开通微信支付,做电商的别想了。第二,小程序包体积限制2M,图片别直接放本地,传到图床或云存储。第三,云开发虽然方便,但免费额度有限,流量一大就烧钱。第四,审核驳回常见原因是类目不匹配,个人主体只能选工具、教育、生活服务这些类目。第五,别在代码里写“测试”字样,审核员会直接打回。从注册到上线,顺利的话两三天就能搞定,但中间每个环节都可能卡你一下。别怕麻烦,按步骤走,遇到问题就查文档,这本身就是学习的过程。