微信小程序开发接口详解，从入门到实战精通

微信小程序开发接口这件事，很多刚入行的朋友一上来就被文档里那几百个API给唬住了。其实真没必要，你每天实际能用到的，翻来覆去就那么二三十个。我见过不少开发者，把官方文档从头翻到尾，笔记记了厚厚一本，真到写代码的时候，还是卡在wx.request怎么封装、页面间怎么传值这些最基本的问题上。这玩意儿就跟学做饭一样，你不需要把菜谱背下来，关键是先把家常菜做顺了，再琢磨创新菜。

咱们先从最基础的网络请求接口说起。wx.request这个接口，是小程序和服务器对话的唯一通道。很多新手容易犯的错，是直接在Page里到处写wx.request，结果代码满天飞，改个域名要翻遍所有文件。正确做法是单独建一个request.js文件，把公共的URL、请求头、超时时间、错误处理都封装好，页面里只需要调用这个公共方法。还有个小细节，请求成功后的状态码判断，别只看res.statusCode是不是200，业务逻辑里经常有code字段，比如code为0才是真成功，这个坑踩的人特别多。

再说说本地存储接口，wx.setStorageSync和wx.getStorageSync这对双胞胎。很多教程告诉你存用户信息、存购物车，这都没错，但有个容易被忽略的场景——页面状态恢复。比如用户在填写一个很长的表单，填到一半不小心退出了，下次进来想让内容还在，这时候用storage接口就非常顺手。要注意的是，storage有10MB的上限，别什么都往里塞，图片、大段日志这些坚决不能存。另外，同步和异步接口的选择上，读取频繁且数据量小的用同步，写入大数据或需要确认结果的用异步，这个取舍新手往往拿捏不准。

页面跳转接口wx.navigateTo和wx.redirectTo，看起来简单，里面藏着不少门道。navigateTo是压栈，页面层级最多十层，超过就跳不动了，这个限制很多人是出了bug才知道。redirectTo是替换当前页，适合登录页跳主页这种场景。还有个容易混淆的是wx.switchTab，只能跳tabBar页面，传参方式跟普通页面不一样，得靠全局变量或者storage。我见过有人用navigateTo去跳tabBar页面，死活跳不过去，查半天才发现是API用错了类型，这种低级错误特别耽误时间。

接下来是用户信息接口，wx.getUserProfile和wx.login这块儿。前两年改版之后，直接调getUserInfo拿不到真实头像和昵称了，必须用户主动点击按钮触发。这个改动让很多老项目栽了跟头，代码没报错，就是拿不到数据。现在的正确姿势是，先调wx.login拿到code，换openid和session_key，再结合getUserProfile获取用户展示信息。这里有个实战技巧，把获取用户信息的流程封装成Promise，配合async/await，代码会清爽很多，不然回调套回调，改起来想砸电脑。

地图和定位接口，wx.getLocation和wx.openLocation这对组合特别实用。getLocation拿经纬度，openLocation打开内置地图导航。但要注意，getLocation在用户拒绝授权后会直接走fail回调，你得做二次引导，不能干等着。还有个容易忽略的点，getLocation返回的经纬度是gcj02坐标系，如果你后端用的是百度地图的bd09坐标系，不转换的话位置会偏几百米，这个误差在实战中很坑人。

实战项目里，接口的调试和异常处理往往比接口本身更花时间。小程序开发者工具里那个Network面板，别只当摆设，每次请求的耗时、返回数据、请求头都能看到，配合console.log，定位问题效率翻倍。还有一点，所有网络请求都得考虑弱网环境，加个超时timeout设置，请求失败时别直接弹error，给个重试按钮，用户体验完全不一样。我见过不少项目，接口一崩就白屏，其实就是少写了catch回调，这种细节决定了你是初级还是资深。

再聊一个很多人不知道但特别实用的接口，wx.createSelectorQuery。这个能帮你拿到页面元素的尺寸和位置信息，做滑动吸顶、滚动加载、动画联动都靠它。比如列表页要做“滚动到某个位置显示返回顶部按钮”，用这个接口监听scrollTop就能精准控制。还有wx.pageScrollTo，配合平滑滚动，体验比直接跳转好得多。这两个接口组合起来，能做很多高级交互效果，关键是文档里写得比较隐晦，实战中需要自己摸索。

说说性能监控相关的wx.getPerformance和wx.setEnableDebug。前者可以拿到页面加载时间、渲染耗时这些指标，后者能开启调试模式。新手可能觉得这些离自己很远，但等到线上出问题，用户反馈卡顿、白屏，你连个数据都没有，只能瞎猜。提前在App.onLaunch里埋好性能统计点，把关键接口的耗时上报到自己的服务器，出了问题能快速定位是前端渲染慢还是后端接口慢，这比什么都强。

从wx.request到wx.createSelectorQuery，每一个接口背后都对应着一类真实的业务场景。别追求把文档背完，把常用的这几个用熟、用透，遇到问题知道去哪查文档、怎么搜解决方案，这才是从入门到实战精通该走的路。小程序开发的接口体系还在不断更新，保持学习的节奏，比死记硬背重要得多。下次写代码的时候，多想想这个接口还能用在什么场景，说不定你就能发现别人想不到的玩法。