最省事是用微信小程序原生物流查询组件，但仅限微信小程序；多端兼容需自调第三方API并手写时间轴UI。
直接用微信小程序原生物流查询组件最省事，但前提是只跑微信小程序；如果要多端兼容（H5、App、支付宝等），必须自己调第三方 API + 手写时间轴 UI。
用微信物流插件前必须确认三件事
uniapp 项目里用 logisticsPlugin 看似一行代码就能打开物流页，但实际卡在三个地方：
- 小程序后台没开通「物流服务 → 查询组件」权限，
openWaybillTracking会静默失败，控制台也不报错 -
manifest.json的mp-weixin.plugins配置漏了版本号或 provider，编译时不会报错，但运行时requirePlugin('logisticsPlugin')返回undefined -
waybillToken不是随便填的——它必须由你后端调用微信物流接口createWaybill获取，前端传错 token 直接白屏
自己调快递鸟 API 时最常踩的坑
用 uni.request 调 https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx，90% 的问题出在参数和签名上：
- 请求头必须带
Content-Type: application/x-www-form-urlencoded，uniapp 默认是application/json，不手动设会返回「请求参数格式错误」 -
ShipperCode不能空着，哪怕你不知道快递公司编码，也得先调一次getExpressComByLogisticCode接口反查，否则轨迹数据里AcceptStation字段全是乱码 - 所有参数必须按文档顺序拼接 + MD5 加密生成
RequestData，少一个字段或大小写不对，就返回{"Success":false,"Reason":"签名错误"}
时间轴 UI 渲染物流节点的关键细节
快递鸟返回的 Traces 是倒序数组（最新状态在 index 0），但时间轴要正序展示，别直接 v-for 原数组：
- 用
traces.slice().reverse()深拷贝再翻转，避免响应式失效 - 每个节点的时间字段是
AcceptTime，格式如"2026-10-28 14:22:05"，别用new Date().toLocaleString()直接转，iOS 会解析失败，得先replace(/-/g, '/') - 状态文案映射不能硬编码，比如
"已签收"在不同快递公司返回值可能是"sign"、"signed"或"签收完成"，建议建个映射表：{ sign: '已签收', pickup: '已揽收' }
多端适配时地图轨迹回放的取舍
如果需求里明确要「在地图上动起来看包裹移动」，别碰 moveAlong——它在 H5 和 App 端表现一致，但在微信小程序里不支持自定义 marker 图标，且无法暂停/拖动进度条：
- 真要跨端，用
translateMarker+ 定时器模拟动画，自己控制 marker 位置和旋转角度，虽然代码多一倍，但 iOS/Android/H5/小程序全都能对齐 - 小程序端如果只求展示静态轨迹线，
polyline属性够用，但注意坐标系：高德用gcj02，腾讯用wgs84，快递鸟返回的是lat/lng，直接塞进去会偏移 500 米以上
最麻烦的其实是状态同步——用户在小程序里点「查看物流」，后端得实时轮询快递鸟接口并缓存结果，否则每次打开都重新查，既慢又容易触发限流。这个逻辑不在前端，但前端得为它留好 loading 和重试入口。
