应延迟至onready或onload后settimeout调用，确保native渲染就绪；需条件编译#ifdef mp-weixin包裹，校验width/height>0，并降级处理低版本兼容问题。
uni.getMenuButtonBoundingClientRect() 返回 null 或空对象怎么办
这个 API 在微信小程序环境里调用，但返回 null 或所有字段为 0 是最常见问题。根本原因不是代码写错，而是调用时机或环境不满足。
- 必须在小程序端运行——
#ifdef MP-WEIXIN包裹，H5/App 端直接调用会报错或返回空 - 不能在
onLaunch或onShow里立即调用，部分低端机型或冷启动时渲染未就绪；推荐放在onReady或首次进入页面的onLoad后加setTimeout延迟 16ms（一帧）再取 - 基础库版本低于 2.1.0 时不支持，需做降级处理：捕获异常后 fallback 到预设值（如
{ top: 44, bottom: 76, left: 220, right: 307, width: 87, height: 32 }）
拿到的 top/bottom/right 坐标到底以谁为原点
所有数值单位都是 px，且统一以「屏幕左上角」为 (0, 0) 原点——不是状态栏顶部，也不是页面容器顶部。这点极易误解，导致计算偏移出错。
-
top是胶囊上边距屏幕顶部的距离，已包含状态栏高度（例如 iPhone 14 Pro 上statusBarHeight是 50px，top可能是 74px，中间那 24px 就是胶囊与状态栏之间的空隙） -
right是胶囊右边距屏幕左边的距离，不是距右边缘；要算右侧留白，得用windowWidth - menuButtonInfo.right -
bottom和top直接相减可得胶囊真实高度：menuButtonInfo.bottom - menuButtonInfo.top === menuButtonInfo.height，可用来交叉验证数据有效性
为什么在 onMounted 里取不到，但在 onReady 里可以
Vue 生命周期和小程序原生渲染节奏不同。onMounted 触发时，页面 DOM 已挂载，但微信小程序的胶囊按钮布局可能尚未完成测量，getMenuButtonBoundingClientRect() 依赖的是 native 层的 layout 信息，必须等 native 渲染树稳定后才可用。
-
uni-app 的
onReady对应小程序的onReady，此时 native view 已 ready，是最稳妥的调用点 - 如果用 Composition API +
onMounted，需配合nextTick+setTimeout双保险，否则在部分安卓机上仍可能取到0 - 不要在 computed 或 setup 顶层同步调用——此时上下文未就绪，必返回空
如何安全地把胶囊信息传给子组件或全局使用
直接在每个页面重复调用既冗余又不可靠（横竖屏切换、键盘弹起后位置可能变化）。更合理的方式是封装成响应式状态，并控制更新边界。
- 用
ref存储结果，在onReady获取后触发一次赋值；后续不主动监听变化（微信暂无resize类事件） - 若需跨页面共享，存入 Pinia/Store 时加标记
isWeixinMP: true，避免 H5 端误读 - 注意内存泄漏：页面卸载时无需手动清理，但若在 onUnload 中重置 store，需确保其他页面不依赖该值——建议只在首页或导航页初始化一次
- 别用
watch监听menuButtonInfo变化来触发重绘，它不会自动变；需要响应式更新的场景，应靠外部事件（如自定义 resize hook）驱动
真正难的不是“怎么取”，而是“取完之后信不信它”。很多项目把 top 当作胶囊距状态栏距离来用，结果在 iPhone 14 Pro Max 上偏移 12px——因为那台机器的空隙比预期大。每次计算前，先校验 menuButtonInfo.width > 0 && menuButtonInfo.height > 0，比硬编码任何经验公式都管用。
