safeareainsets 有时为 undefined 是因平台兼容性差异，需做空值兜底；css 应同时写 constant() 和 env() 且 env 在后；h5 需 viewport-fit=cover；自定义 tabbar 必须显式加 padding-bottom: env(safe-area-inset-bottom)。
uni.getSystemInfoSync() 返回的 safeAreaInsets 为什么有时是 undefined？
因为不是所有平台、所有版本都原生支持安全区数据。iOS 和较新安卓（Android 9+ 厂商定制系统）才稳定返回，旧安卓、H5、微信小程序模拟器、部分低端机型可能直接不提供该字段。
- 不要假设
safeAreaInsets一定存在，必须做空值兜底：systemInfo.safeAreaInsets?.bottom || 0 - 不能靠
platform === 'ios'粗暴判断——有些 Android 也有刘海/挖孔，且safeAreaInsets可能非零；也不能靠model字符串硬匹配（如含 “iPhone”），因为模拟器或越狱设备可能伪造 - 真机调试前务必关掉 HBuilderX 的“运行时调试”开关，否则某些平台会屏蔽原生能力导致
safeAreaInsets为空
CSS 中 env(safe-area-inset-bottom) 和 constant(safe-area-inset-bottom) 怎么选？
env() 是标准写法，constant() 是 iOS 11.0–11.2 的临时兼容方案，现在基本可弃用。但二者必须同时写，并把 env 放在后面，否则老 iOS 会忽略整个声明。
- 正确顺序：
padding-bottom: constant(safe-area-inset-bottom); padding-bottom: env(safe-area-inset-bottom); - H5 端需确保
<meta name="viewport" content="viewport-fit=cover">存在，否则env()不生效 - App 端（iOS）即使写了，若 manifest.json 里
"app-plus": { "safearea": { "bottom": { "offset": "auto" } } }，系统仍可能叠加一层默认内边距，导致 double-padding —— 这时候应设为"none"，完全交由 CSS 控制
自定义 tabbar 底部空白怎么清掉？
这是最常被问却最容易错的地方：uni-app 内置 tabbar 会强制预留底部安全距离，哪怕你设了 offset: "none" 或写了 env()，它依然存在。真正有效的解法只有一条——不用内置 tabbar。
- 改用自定义 tabbar 组件（如 uView 的
u-tabbar或手写view+position: fixed） - 自定义 tabbar 的根容器必须加类名（比如
tabbar-safe-area），并在 CSS 中显式设置：.tabbar-safe-area { padding-bottom: env(safe-area-inset-bottom); } - 关键点：没有这句
padding-bottom，安全区永远无效；很多开发者写了 CSS 变量却忘了加到 tabbar 根节点上 - 如果坚持用内置 tabbar，那底部空白就是设计行为，无法彻底消除——这是 uni-app 原生层的硬限制
manifest.json 里 safearea 配置到底要不要动？
要动，但只在明确需要「全局接管」时才改。多数项目不该碰它，默认 "auto" 已足够稳妥；乱设反而引发冲突。
-
"offset": "none"意味着放弃系统默认保护，你得自己确保按钮不被 Home Indicator 遮住——适合全屏视频、游戏页等强控制场景 -
"background": "#000"只影响安全区背景色，对布局无影响；但若页面背景非纯色（比如渐变、图片），这里设色反而暴露白边 - Android 端设
"offset": "none"基本没用，因为安卓安全区逻辑不在 manifest 控制，而依赖safeAreaInsets或厂商 API
viewport-fit=cover，App 页面没关掉内置 tabbar，以及所有地方都忘了给 safeAreaInsets 做 || 0 兜底。这三个点一漏，适配就断在第一环。
