必须四参数齐备：width=device-width、initial-scale=1.0、minimum-scale=1.0、maximum-scale=1.0；dblclick、gesturestart、touchstart 均需绑定 document.documentElement 并设 passive: false；iframe 需单独设置 touch-action；时间戳防误判需全局统一管理。
viewport meta 标签必须写全四项参数
单靠 user-scalable=no 在 iOS 16+ 和现代安卓浏览器里根本不起作用——它会被系统级忽略。真正起效的写法是四参数齐备：width=device-width、initial-scale=1.0、minimum-scale=1.0、maximum-scale=1.0，缺一不可。
常见错误包括：只写 user-scalable=no；漏掉 initial-scale=1.0 导致 Safari fallback 到非整数缩放；把 meta 标签放在 CSS 或 JS 后面，被后续脚本覆盖。
-
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0">是底线配置，user-scalable=no可加可不加，但加了别指望它生效 - 该标签必须静态写在
<head>最顶部，JS 动态插入完全无效 - 如果页面内容高度超出视口（
document.documentElement.scrollHeight > window.innerHeight），iOS Safari 会强制启用双指缩放，无视所有 meta 设置
dblclick 事件监听必须绑定到 document.documentElement
双击放大本质是两次快速 touchend 触发的 dblclick，但 iOS Safari 对它的拦截极其敏感——绑错目标或设错选项，一次漏掉就放大。
不能绑 document.body，因为 DOM 可能还没就绪；也不能用 passive 默认值，否则 e.preventDefault() 被静默忽略。
立即学习“前端免费学习笔记（深入）”；
- 正确写法：
document.documentElement.addEventListener('dblclick', e => e.preventDefault(), { passive: false }) - 注册时机建议在
DOMContentLoaded后立即执行，或内联在<body>底部 - 仅靠这个还不够：iOS 15+ 下，用户快速双击后立刻捏合，
dblclick根本不触发，必须配合gesturestart和touchstart拦截
gesturestart + touchstart 是绕过 iOS 双指缩放的关键
双指捏合缩放由 gesturestart 独立驱动，它比 touchstart 更早触发，且不依赖 touches 数量判断。只拦 touchstart 会漏掉部分场景。
同时，touchstart 中检测多点触控是防误触的第一道防线——哪怕用户只是无意放上第二根手指，也会提前阻断缩放流程。
- 必须监听
document.documentElement，不是body或某个按钮容器 -
gesturestart拦截：document.documentElement.addEventListener('gesturestart', e => e.preventDefault(), { passive: false }) -
touchstart拦截：if (e.touches.length > 1) e.preventDefault()，同样要带{ passive: false } - iframe 嵌入的内容（如地图、视频）需单独对其设置
touch-action，父页面样式不继承
touchend 时间戳逻辑防快速双击误判
双击放大实际是两次 touchend 间隔 ≤ 300ms，但单纯监听 dblclick 在某些低延迟触控场景下会失效。时间戳缓存是目前最稳定的兜底方式。
注意：不能只监听一次 touchend 就重置时间戳，否则会误杀正常点击；也不能对每个按钮单独处理，必须全局统一管理。
- 声明变量：
let lastTouchEnd = 0 - 监听
touchend：if (Date.now() - lastTouchEnd ，然后更新 <code>lastTouchEnd - 这个逻辑必须和
gesturestart、touchstart配合使用，单独存在仍可能被绕过 - 不要给按钮加
touch-action: manipulation—— 它会禁用所有原生双指手势，PDF 查看器、地图拖拽等交互直接废掉
真正起效从来不是靠某一个属性或事件，而是 viewport 四参数 + gesturestart + touchstart + touchend 时间戳 + dblclick 的四层叠加。最容易被忽略的是 { passive: false } 这个选项，以及 document.documentElement 这个绑定目标——写错任何一个，整套方案就形同虚设。
