viewport meta标签错误是移动端布局偏差最常见原因，必须写在head内且含width=device-width、initial-scale=1、user-scalable=no；避免固定width、maximum-scale等错误写法，并配合safe-area-inset和100dvh处理全面屏。
viewport meta 标签没写对，页面在手机上缩放错乱
移动端布局偏差最常见原因就是 <meta name="viewport"> 缺失或属性值错误。它不控制样式，但决定了浏览器用多大画布来渲染你的 CSS —— 画布歪了，再准的 rem 或 flex 都会偏。
实操建议：
- 必须写在
<head>内，且越靠前越好（避免 Flash of Unstyled Content） - 基础写法只用这三项：
width=device-width、initial-scale=1、user-scalable=no（后者按需，多数业务可加） - 别写
maximum-scale=1或minimum-scale=1—— 它们在 iOS 10+ 已被忽略，还可能触发 Safari 的兼容模式降级 - 不要用
width=375或其他固定数值 —— 这会让 iPhone Plus/Pro Max 等设备强行拉伸渲染，文字糊、按钮小
initial-scale=1 不生效？检查是否被 Safari 自动缩放覆盖
iOS Safari 有个隐藏规则：如果页面有未设置 width 的 <table>、长单词、或单行超宽元素（比如没设 max-width 的 <img>），它会无视 initial-scale=1，自动缩小整个视口来“适配”内容。
常见错误现象：
立即学习“前端免费学习笔记（深入）”；
- PC 调试正常，真机打开却变小、字体发虚
- 页面右滑能露出大片空白 —— 实际是视口被强制缩放后，CSS 布局仍按 device-width 计算，但渲染画布变窄了
排查方法：
- 在 Safari 开发者工具里看
document.documentElement.clientWidth，如果远小于window.screen.width，基本就是被缩放了 - 临时加
* { outline: 1px solid red; }，快速定位撑破容器的元素 - 给所有图片加
img { max-width: 100%; height: auto; }，表格加table { width: 100%; table-layout: fixed; }
适配全面屏/折叠屏，不能只靠 viewport
viewport 只管初始渲染画布，不处理刘海、挖孔、动态折叠带来的安全区域变化。iOS 的 env(safe-area-inset-bottom) 和 Android 的 safe-area-inset CSS 环境变量才是关键。
使用场景：
- 底部 TabBar 被 iPhone 底部手势条遮住
- 折叠屏展开后，原本写死
height: 100vh的弹层高度溢出
实操建议：
- 用
padding-bottom: env(safe-area-inset-bottom)替代固定padding-bottom: 34px - 避免直接用
100vh做全屏高度，改用100dvh（dynamic viewport height），它会随安全区域实时更新 - 注意兼容性：
100dvh在 Safari 16.4+、Chrome 105+ 支持；老版本需回退到100vh+ JS 监听resize手动修正
Vue/React 项目里动态修改 viewport？别这么做
运行时用 JS 修改 <meta name="viewport"> 的 content 属性，对已加载页面几乎无效。Chrome 和 Safari 都只在首次解析时读取该标签，后续修改不会触发布局重算。
容易踩的坑：
- 在 Vue Router 导航守卫里写
document.querySelector('meta[name=viewport]').setAttribute(...)—— 无用 - 想用不同
scale适配横竖屏切换 —— 浏览器根本不响应，且横屏下device-width本就指当前方向宽度，无需手动干预 - SSR 渲染时服务端拼接 viewport 标签，但客户端 hydration 后又被 JS 覆盖 —— 白忙活，还可能引发 FOUC
真正需要动态控制缩放的场景极少，绝大多数问题都该回归到 CSS 布局和响应式设计本身。viewport 是启动参数，不是运行时开关。
复杂点在于：它看似简单一行，实则牵扯渲染管线起点、系统级缩放策略、以及各平台对「设备宽度」的定义差异。漏掉一个 initial-scale=1，后面所有媒体查询和单位换算都在错误基准上运行 —— 修复时得从根上查，而不是调 margin。
