不能靠“自适应”自动解决，必须用 env() 手动注入安全区偏移，并配合 @supports 和 max() 做兼容，否则在 iPhone X/XR/12/14/15/16 等设备上，顶部状态栏或底部 Home Indicator 会遮挡内容。
直接说结论：不能靠“自适应”自动解决，必须用 env() 手动注入安全区偏移，并配合 @supports 和 max() 做兼容，否则在 iPhone X/XR/12/14/15/16 等设备上，顶部状态栏或底部 Home Indicator 会遮挡内容。
viewport-fit=cover 是硬性前提，缺了它 env() 全是 0px
iOS 只有在明确启用视口扩展时才注入 safe-area-inset-* 值。必须确保页面 <head> 中存在且未被 JS 覆盖的这行 meta：
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
-
initial-scale=1.0不能省——iOS Safari 仅在此条件下解析env() - 微信内置浏览器（X5 内核）、部分 PWA 加载器、或第三方 SDK 可能动态重写
<meta>，导致viewport-fit=cover实际丢失 - 安卓设备（包括 Chrome 90+）完全不识别该属性，
env()恒为0px，别指望它生效
@supports (padding-top: env(safe-area-inset-top)) 必须写对语法
检测不是查函数是否存在，而是查这条 CSS 声明能否被浏览器接受。写错就整块规则失效：
- ❌ 错误：
@supports (env(safe-area-inset-top))——语法非法，浏览器直接跳过 - ❌ 错误：
@supports (background: env(safe-area-inset-top))——旧版 Safari 对非布局属性支持不稳定 - ✅ 正确：
@supports (padding-top: env(safe-area-inset-top))，然后在里面写具体样式 - fallback 值建议设为
44px（iPhone 竖屏刘海典型高度），别用0，否则老设备上 header 会塌陷
只作用于需要避让的容器，别污染全局
给 <body> 或 <html> 直接加 padding-top: env(safe-area-inset-top) 是最常见错误：
立即学习“前端免费学习笔记（深入）”；
- 会导致整个页面下移，header 被顶出视口上方，内容区域实际可视高度变小
- 正确做法是只作用于真正贴顶/贴底的元素，比如自定义导航栏或底部 TabBar
- 底部固定按钮推荐用：
padding-bottom: max(0px, env(safe-area-inset-bottom))，max()是关键兜底——不支持env()的浏览器会退化为0px，不会丢弃整条声明 - 别用
calc(100vh - env(safe-area-inset-bottom))做全高布局，滚动时100vh会变化，底部错位
JS 里读不到 env()，内联样式无效
env() 是纯 CSS 运行时变量，JavaScript 层无法访问：
- ❌
style={{ paddingTop: 'env(safe-area-inset-top)' }}在 React/Vue 中完全不生效，JS 只当字符串透传，浏览器不解析 - ❌
getComputedStyle(el).getPropertyValue('padding-top')返回的是计算后值（如"44px"），但getComputedStyle(el).getPropertyValue('--safe-area-inset-top')永远是"unset" - 真机调试时，用 Safari 开发者工具检查
Computed面板里的padding-top是否真为非零值，比看代码更可靠 - 如果必须 JS 控制（比如动态开关导航栏），建议用
matchMedia+ UA + 宽高比粗略判断，而非依赖env()
最易被忽略的一点：这些值是动态的。横屏时 env(safe-area-inset-top) 可能从 44px 变成 24px，折叠屏、多任务侧边栏等场景下 left/right 也可能非零——不能当成静态常量硬编码进逻辑里。
