微信小程序开发中，卡在“方法调用”这个环节——不是不知道API名字，而是不知道什么时候该用哪个、用错了会有什么后果。今天咱们就把那些高频的、容易混淆的、但真正能解决实际问题的常用方法，掰开揉碎了讲清楚。

先从一个最常见的场景说起：页面跳转与数据传递。很多新手喜欢用wx.navigateTo，觉得它简单。但如果你连续跳转五六个页面，用户点返回时就要一层层退，体验极差。这时候wx.redirectTo更合适——它会关闭当前页面，直接跳转，用户按返回键直接回到上一级页面，而不是跳转链条的中间层。比如在登录页跳转到首页，用redirectTo就比navigateTo合理，因为用户没必要再回到登录页。

再比如页面间传参，用url?key=value的方式，但传复杂对象时就傻眼了。这时候可以配合encodeURIComponent把JSON转成字符串，到了目标页面再用decodeURIComponent解析。但有个坑：URL长度有限制，如果数据量大（比如一整个商品详情），建议用wx.setStorageSync存到本地，目标页面再读取。对比一下：URL传参适合少量、简单的数据（比如ID）；本地存储适合中等规模、需要持久化的数据（比如用户配置）；而全局变量getApp().globalData适合跨页面频繁访问的临时数据（比如购物车状态）。

说到数据缓存，wx.setStorageSync和wx.getStorageSync是同步方法，图方便一股脑全用同步。但注意，同步操作会阻塞线程，如果数据量大（比如图片base64字符串），页面会卡顿。这时候用异步的wx.setStorage更稳妥，它不会阻塞后续代码执行。举个例子：用户退出登录时清空缓存，如果数据量不大（比如几个key），用同步没问题；但如果要清空整个wx.getStorageInfoSync().keys遍历删除，异步方法能避免“清空过程中用户点了个按钮”导致的并发问题。

另一个容易踩坑的是网络请求。写wx.request直接复制官方示例，但忽略了method默认是GET。如果接口要求POST但你没指定，后台收到的是GET请求，返回404或者参数丢失。还有header里的Content-Type，如果你传JSON数据，必须写成'Content-Type': 'application/json'，否则后端解析不了。更隐蔽的是dataType，默认是json，如果接口返回的是纯文本（比如某些老系统返回XML），不改成text会导致解析失败。建议每次写请求时，把method、header、dataType三个字段都显式写出来，避免依赖默认值。

再聊一个用户交互反馈的方法。做加载中状态时，直接用wx.showLoading，但忘了加mask: true。不加的话，用户还能点击页面其他按钮，可能触发重复请求。加了遮罩层后，用户无法操作，直到你调用wx.hideLoading。但要注意：showLoading和showToast不能同时存在，否则toast会被loading盖住。正确做法是：先hideLoading，再showToast。还有showModal，它的cancelText和confirmText可以自定义，但不要写“确定”和“取消”这种干巴巴的，改成“去支付”和“再看看”，转化率会提高。

说到组件通信，在自定义组件里用this.triggerEvent触发父组件事件，但传参时容易犯一个错：第二个参数是detail对象，但如果你直接传一个字符串，父组件收到的event.detail就是那个字符串。如果想传多个参数，必须包成对象，比如this.triggerEvent('myevent', { id: 1, name: 'test' })。另外，父组件监听事件时，bind:myevent的写法比bindmyevent更规范，因为微信官方推荐用冒号分隔。

还有一个被忽略的性能优化方法——wx.nextTick。当你在setData之后立刻想操作DOM（比如获取某个组件的高度），直接写代码会拿到旧数据。因为setData是异步的，DOM还没更新。这时候用wx.nextTick包裹后续操作，就能保证DOM已经渲染完毕。比如做一个“滚动到最新消息”的功能：先setData追加数据，再wx.nextTick里调用wx.pageScrollTo，位置就对了。

最后聊一个设备能力调用的细节。用wx.getLocation获取用户位置，但发现安卓和iOS返回的坐标系不一样。安卓默认返回gcj02（国测局坐标），iOS返回wgs84（GPS坐标）。如果你要用在地图上显示，必须统一转成gcj02，否则位置偏移几十米。解决办法：调用时指定type: 'gcj02'。还有wx.scanCode扫码，如果用户拒绝授权，不会触发fail回调，而是直接不反应。所以一定要先调用wx.authorize申请摄像头权限，如果用户拒绝，再用wx.openSetting引导去设置页打开权限。

这些方法看似零散，但实际开发中环环相扣。比如你从页面A跳转到页面B（用redirectTo），B页面要请求数据（用request），请求时显示加载中（用showLoading带遮罩），数据回来更新页面（setData），然后隐藏加载（hideLoading），再根据结果决定是否弹窗（showModal）。每一步的方法选错，都会导致体验崩塌。建议你把每个方法都写成一个独立的工具函数，比如requestWithLoading，把loading逻辑封装进去，这样每个页面调用时就不用重复写那些样板代码了。