viewport meta标签必须正确设置为，否则页面在手机上会缩成一团，导致响应式布局失效。
viewport meta标签写不对，页面在手机上直接“缩成一团”
绝大多数响应式失效的根源，不是CSS没写@media，而是<meta name="viewport">压根没加，或者写了但content值错得离谱。iOS Safari和Android Chrome默认把页面当980px宽渲染，不加这个标签，width: 100%就等于“100%的980px”，不是你屏幕的物理宽度。
正确写法只有一条底线：<meta name="viewport" content="width=device-width, initial-scale=1">。必须放在里，且不能被JS动态插入（部分安卓WebView不识别）。
-
width=device-width：让视口宽度匹配设备逻辑像素（比如iPhone 14是390px），不是物理像素也不是固定值 -
initial-scale=1：禁止双击缩放后页面“突然变小”，也避免加载瞬间闪动 - 别加
user-scalable=no——不仅伤 Accessibility，iOS 16+ 还会强制忽略整个viewport声明 - 不要写
width=375或width=1280，这是自废响应式武功
CSS媒体查询生效但布局还是错位？检查viewport是否被重复注入
Vue/React项目常见陷阱：路由切换时，组件内JS又塞了一个<meta name="viewport">，导致浏览器收到两个冲突声明。Chrome DevTools 的 Application > Manifest 标签页看不到它，但Elements > head里能翻出重复项。
真实报错现象：DOMException: Failed to execute 'appendChild' on 'Node'（极少报），更多是静默失效——你改了@media (max-width: 768px)，但iPad横屏死活不触发。
立即学习“前端免费学习笔记（深入）”；
- Next.js用户：删掉
next/head里手动写的viewport，用next.config.js的experimental.viewport配置（v13.4+） - Nuxt用户：统一配
app.head.meta，别在onMounted里document.head.appendChild - 纯HTML项目：确保整个页面只有一个
<meta name="viewport">，且位置在所有其他<meta>之后、<title></title>之前
安卓WebView里viewport失效？可能是系统级缩放策略在捣鬼
部分国产安卓App（微信、QQ、钉钉）内嵌WebView会强制覆盖viewport，尤其当用户在系统设置里调高了“字体大小”或“显示缩放”。这时initial-scale=1可能被无视，页面文字被放大，容器却没重排。
这不是你的CSS问题，但有折中解法：用text-size-adjust: none（加在html或body上），不过要小心——iOS Safari 9+已废弃该属性，仅对旧版安卓WebView有效。
- 更稳的方案：用
clamp()替代固定font-size，例如font-size: clamp(14px, 4vw, 18px)，让字号随视口弹性变化 - 避免用
rem基于html { font-size: 16px }做全局基准，安卓WebView可能偷偷改了根字体大小 - 测试真机时，务必关闭系统“强制使用大号文字”开关，否则所有调试都是白忙
用CSS容器查询替代viewport？现在还不行
有人想绕过viewport，直接用@container做响应式。但注意：@container依赖父容器的contain: layout style size，而视口本身不是DOM容器——你没法给body加contain然后监听它变宽变窄。
目前唯一能响应视口变化的，还是@media + 正确viewport。容器查询解决的是“组件内部尺寸变化”，比如卡片从单列变双列，不是“手机横屏竖屏切换”。
-
@container需要display: container（尚未成为标准），当前仅Chrome 110+支持，且必须配合container-name - 试图用
ResizeObserver监听window.innerWidth再手动切class？性能差、有延迟、无法触发伪类（如:hover状态） - 真正该省心的地方：别在CSS里写
width: 320px，用width: 100vw或max-width: 100%，让viewport规则自然传导到布局层
viewport不是锦上添花的配置，它是CSS媒体查询能工作的前提。漏掉它，后面所有@media、rem、vh单位都在赌浏览器的兼容策略——而现实是，没人会为你赌赢。
