去年夏天，一个做餐饮连锁的朋友来找我，说想搞个小程序点餐，省得顾客排队。我问他预算多少，他说两万。又问他团队呢，他说就他自己。我当场就笑了——这哥们儿连HTML和CSS都分不清，却以为小程序跟发朋友圈一样简单。但三个月后，他的点餐小程序真上线了，花了不到八千块。这事儿给我的触动挺大：小程序开发的门槛，确实被工具和平台压得很低了，但该踩的坑，一个都不会少。

很多人一上来就搜“小程序开发多少钱”，或者“需要学什么语言”，这其实问错了方向。微信小程序本质上是运行在微信里的一个网页应用，核心语言是JavaScript、WXML和WXSS，看着像前端三件套，但坑在于它的运行环境不是浏览器，而是微信自己搞的一套渲染引擎。这就意味着你平时写网页的那套习惯，比如随便用DOM操作、用jQuery，在这儿全得扔掉。我第一次写小程序时，想用，结果控制台直接报错，那一刻我才意识到，这不是换个框架那么简单，得重新学一套游戏规则。

注册账号是第一步，但这一步就能卡住不少人。个人主体只能注册非商业类小程序，想上支付、做商城，必须企业主体。我那个朋友，为了注册，专门去办了营业执照，花了半个月。注册完还得做微信认证，交300块钱审核费，这个钱每年都要交，别想着省。认证通过后，你会得到一个AppID，这玩意儿相当于小程序的身份证，后面所有配置都离不开它。开发工具推荐用微信官方那个“微信开发者工具”，虽然界面丑得像个老式收音机，但调试、预览、上传，全得靠它。别嫌它丑，你越早适应越好。

接下来是项目结构，这个必须掰扯清楚。是全局逻辑，是全局配置，是全局样式，这三个文件是地基。页面文件放在目录下，每个页面由、、、四个文件组成，缺一不可。我第一次写的时候，忘了建文件，结果页面直接白屏，查了半天才发现是配置文件缺失。里最常用的配置是数组，这里面写的第一个页面就是首页，顺序错了，首页就变了。还有个细节，节点里可以设置导航栏标题和背景色，这些看似小事，但直接影响用户第一印象。

页面生命周期这块，是新手最容易懵的地方。在页面加载时触发，在页面显示时触发，在页面首次渲染完成时触发。这三个顺序是： → → 。如果你在里请求数据，页面还没渲染完，数据回来时可能会出现闪烁。我一般习惯在里调接口，在里做DOM相关的操作，比如获取节点信息。还有一个，页面销毁时触发，用来清理定时器或取消订阅，不写这个，内存泄漏等着你。

数据绑定是WXML的灵魂，但跟Vue那种双向绑定不一样，小程序是单向的。你在JS里改数据，得用，直接是不生效的。很多人觉得这多此一举，但你得理解，的本质是把数据从逻辑层传到渲染层，这个过程有性能开销。所以别频繁调用，比如在滚动事件里每帧都更新，那页面能卡成PPT。我见过一个新手，把一个大数组整个进去，结果页面直接白屏。正确做法是只更新变化的那部分数据，或者用的第二个参数做回调，处理数据更新后的逻辑。

组件化开发，是项目变大后的救命稻草。微信内置了、、这些基础组件，但业务组件你得自己封装。比如一个商品卡片，你可以写成，然后在多个页面引用。组件的生命周期跟页面不一样，相当于页面的，相当于，相当于。组件之间的通信，父组件用给子组件传值，子组件用向父组件抛事件。这套机制看着绕，但用熟了之后，代码复用率能提升一大截。

网络请求这块，必须说个坑。小程序的只支持HTTPS，而且域名必须在小程序后台配置白名单，还得是备案过的域名。我朋友第一次测试，用本地IP，直接报错“url not in domain list”，他以为是代码问题，查了半天才发现是域名没配。开发阶段可以在工具里勾选“不校验合法域名”，但真机预览时，这个选项就不管用了。另外，的回调里，要自己判断，别以为返回200就万事大吉，业务状态码还得自己处理。接口封装建议写个公共方法，统一处理加载态、错误提示、登录态失效这些逻辑，不然每个页面写一遍，改起来能疯。

说到登录，这是小程序开发里最绕的一环。很多人以为用拿到code，然后传给后端就能登录了，其实这只是第一步。的code有效期只有5分钟，而且只能用一次。你得把code发给自己的服务器，服务器再用code去微信的接口换和。这个绝对不能下发到前端，不然你的接口安全性就废了。更麻烦的是，微信这几年加强了隐私保护，接口已经改了，现在拿用户头像昵称，得用组件的，或者的类型。这些细节，不踩一次坑，根本记不住。

聊聊发布流程，这可能是最容易被忽视但最关键的一环。写完代码，在开发者工具里点“上传”，填个版本号和备注，然后在微信公众平台的后台“版本管理”里找到这个版本，先提交审核。审核一般1-7天，运气好一天过，运气不好，因为一个截图不规范被驳回，又得改。审核通过后，还得手动点“发布”，这步很多人忘了。发布后，如果发现线上有bug，别慌，可以用“版本回退”功能，回到上一个版本。还有个小技巧，开发版和体验版可以同时存在，体验版能让你和同事在真机上测，不用等审核。我那个朋友，就是靠体验版，在店里反复测了一周，才敢提交审核。

回头看，从零到一写一个小程序，真不是难在代码，而是难在那些文档里写得含糊、网上又搜不全的细节。注册认证、项目结构、生命周期、数据绑定、组件通信、网络请求、登录授权、发布审核，每个环节都像一块拼图，缺一块，整个画面就拼不出来。但好消息是，这些坑都是固定的，你踩过一次，就永远记住了。小程序这行当，最怕的不是不会写，而是不敢开始。打开开发者工具，新建一个项目，把默认的“Hello World”跑起来，你就已经赢了八成的人。剩下的，就是像我那个朋友一样，边做边学，边踩坑边填坑，三个月后，你也能拿着自己的作品，跟别人说：这玩意儿，没那么玄乎。