刚接手小程序项目，看到别人代码里一堆wx.request、wx.setStorageSync，不知道从哪查起。其实官方把这些接口统一叫微信小程序api，全部以wx开头，按功能分好类。别急着背，先想清楚要做什么功能，再回来查对应接口。

网络请求是第一个坎

wx.request相当于浏览器里的fetch，用来发HTTPS请求，微信小程序api里数它用得最勤。注意上线前要在小程序管理后台把接口域名配置进request合法域名列表，协议必须是HTTPS，正式版没这一步会直接请求失败，本地调试可以勾选不校验合法域名选项临时绕开。

常见分类大致有这些：

  • 网络：wx.request、wx.uploadFile、wx.downloadFile。
  • 存储：wx.setStorageSync和wx.getStorageSync，单条上限1MB，总量10MB。
  • 交互：wx.showToast、wx.showModal、wx.showLoading。
  • 导航：wx.navigateTo、wx.redirectTo、wx.switchTab，tab页只能用switchTab跳转。
  • 登录身份：wx.login拿code换openid，昵称头像这类信息有单独的授权流程。

用的时候留意三件事

第一，多数异步接口同时支持回调和Promise两种写法，新项目建议统一风格，混着写后期难维护。第二，敏感类接口比如定位、相册、蓝牙，必须在小程序后台声明用途才能调用，审核会查。第三，wx.login返回的code只能用一次且有时效，过期要重新获取，后端换session的流程别写死在本地缓存里。

查文档认准官方开发者文档的小程序板块，每个接口都标注了可用平台和基础库版本要求，低版本基础库调用新接口会直接报错。真机调试时多看调试器console里的报错，能定位大半问题。