上周有个客户的技术员来咨询，人是从微信端转过来的，装好百度开发者工具一跑，模拟器白屏加一串报错，当场就想放弃。其实这不是百度小程序开发有多难，而是两家的语法细节有差别，先把差别摸清，上手就顺了。
工具先装对，环境先配好
第一步是去百度智能小程序官网下载最新版开发者工具，别拿群里传的老安装包，工具更新很勤，旧版本经常连新项目都建不了。装好后用百度账号登录，把平台后台拿到的 AppID 填进去，模拟器就能预览了。真机预览记得扫码调试，很多模拟器上正常的页面，到真机上样式就歪，尤其是安卓低配机，别省这一步。
wx 改成 swan，对应关系要记牢
两边的接口命名大部分是同一个思路，微信里 wx.request，百度端就是 swan.request，把前缀换掉能解决大半问题。但不是所有接口一一对应：登录授权、支付、分享这些平台强绑定的能力，参数和回调结构都有出入，直接替换会埋雷。老练的做法是抽一个适配层，把请求、存储、登录这些高频接口封一层，两端各写一份实现，页面层只调适配层，后面再加平台也从容。
调试环节的三个坑
- 基础库版本：低版本基础库不支持新组件，报错信息还看不出来是版本问题
- 本地缓存：改了代码没生效，先把工具缓存清了再编译
- 域名校验：请求的域名没在后台配置，真机上全部失败，模拟器却看不出异常
这三条里域名校验最隐蔽，上线前把 request 合法域名一项项核对，比事后排查省事。
几个常用面板，值得花十分钟认熟
顶部机型切换里选几台主流机型，页面宽度一变，布局稳不稳立刻现形。Network 面板能看到每个请求的耗时和返回内容，接口慢在哪一步，这里最直观。Console 会把报错定位到文件和行号，红字别划过去，点开看，多数问题十行以内就能定位到原因。
存储管理面板可以清掉本地缓存和授权数据，测登录流程时特别有用，授权关系乱了清一下重来，比卸载重装快得多。另外提醒一句，工具版本更新后偶尔会改默认设置，行为突然变了，先翻一眼更新日志再排查，能少绕不少弯路。这几个面板用熟了，排查问题的速度和完全不懂工具的人比，差着好几倍。
给刚转过来的团队一句实在建议：先花半天通读官方语法对照文档再动手写代码。百度小程序开发的调试和微信端思路相通，差别都藏在细节里。项目时间紧的，也可以交给比格网络这样两端都做过的团队，适配方案现成，比现学现卖稳当。
