17370845950

必须设置viewport meta标签并配合env()函数处理安全区域。iPhone Safari默认以980px渲染，需用width=device-width激活响应式；安全区域需用env(safe-area-inset-top/bottom)留白；REM布局应先媒体查询兜底再JS微调，避免首屏错乱。

viewport 设置不对，页面直接“缩成一团”或“文字小得看不清”

iPhone Safari 默认以 980px 宽度渲染网页，如果没声明 viewport，哪怕你写了 width: 100%，它也会把整个页面缩进一个窄窗口里，导致触摸目标错位、字体发虚、Flex 布局塌陷——这不是 bug，是 Safari 的“桌面兼容模式”在作祟。

• 必须加这行：

• width=device-width 是核心，它让虚拟视口宽度 = 设备物理屏幕宽度（如 iPhone 15 Pro 是 393px）；initial-scale=1 确保不缩放；user-scalable=no 防止用户双指误操作放大后布局崩坏
• 别用 width=320 或 width=375 这类固定值——iOS 系统会忽略它，或触发强制缩放逻辑，反而更难控制
• 如果页面要支持横屏切换，记得补充 viewport-fit=cover（尤其 iPhone X 及以后机型），否则刘海区/圆角区内容会被裁掉

本地 HTML 文件打不开交互功能？不是 Safari 的锅，是系统限制

iPhone 自带的“文件”App 和 Safari 都不支持直接执行本地 HTML 文件里的 localStorage、fetch 或 Canvas 动画——这是 iOS 的安全沙盒机制决定的，和 HTML5 标准无关。

• 用 Safari 打开本地文件（比如通过 AirDrop 接收的 index.html），地址栏会显示 file:///，此时 JS 脚本可能静默失败，控制台也看不到报错
• 真正能跑全功能的方案只有两个：Documents by Readdle（内置 WebKit 引擎，支持 file:// 协议 + JS 执行）或 iCab Mobile（可设为默认浏览器，本地文件点击即运行）
• 开发调试阶段更推荐：把文件扔进 iCloud Drive，用 Safari 访问 https://www.icloud.com/.../index.html 链接——走 HTTPS 就绕过所有本地协议限制

iPhone X 及以后机型的“安全区域”吃掉了你的按钮和导航栏

从 iPhone X 开始，顶部刘海、底部 Home Indicator 区域属于“非安全区域”，CSS 默认会把内容铺满整个屏幕，结果就是关键按钮被遮住、底部 TabBar 被顶起、状态栏文字叠在 Logo 上。

• 必须用 CSS 函数 env(safe-area-inset-top)、env(safe-area-inset-bottom) 等来留白，例如：

  body { padding-top: env(safe-area-inset-top); padding-bottom: env(safe-area-inset-bottom); }

• 只靠 @media 查询设备宽度没用——iPhone 14 Pro 和 iPhone 15 Pro Max 屏幕宽度都是 393px，但安全区域高度不同，必须依赖 env()
• 如果用了 position: fixed 的底部导航，记得加 padding-bottom: env(safe-area-inset-bottom) 到父容器，而不是直接设 bottom: 0，否则 Home Indicator 会盖住按钮

REM 布局算不准？根源常在 font-size 的初始值没随屏幕动态重设

很多人写 REM 布局时，直接在 html 上写死 font-size: 16px，再用 JS 按比例放大——但 iOS Safari 在页面加载早期会强制重置根字号，导致 JS 计算滞后，首屏渲染错乱。

• 推荐做法：用媒体查询做“兜底”，再用 JS 微调。例如先写：

  @media (min-width: 375px) { html { font-size: 100px; } }
  @media (min-width: 414px) { html { font-size: 108px; } }

• JS 部分只负责修正小数点后精度，比如检测到 window.innerWidth === 393，就补上 document.documentElement.style.fontSize = '103.5px'
• 千万别用 rem 做动画或过渡的单位——iOS Safari 对 rem 的重绘性能较差，容易卡顿，这类场景统一换 px 或 em

实际适配中最容易被跳过的，是 viewport-fit=cover 和 env() 的组合使用——它不报错，也不警告，只是悄悄把你的按钮藏进刘海里。