报错根源是浏览器默认将touchmove设为passive，需显式声明{passive: false}才能调用preventDefault()；推荐优先使用touch-action CSS属性控制手势，按需在特定区域启用非被动监听。

touchmove 事件里 preventDefault() 报错：`Unable to preventDefault inside passive event listener`

这是 iOS Safari 和 Chrome for Android 最常见的报错，根源是现代浏览器默认把 touchmove 监听器设为「被动（passive）」，即禁止在其中调用 preventDefault()——除非你明确告诉它“我要主动干预”。

• 错误写法：

  document.addEventListener('touchmove', e => e.preventDefault());

• 正确写法（必须加 {passive: false}）：

  document.addEventListener('touchmove', e => e.preventDefault(), {passive: false});

• ⚠️ 注意：passive: false 不能省略，且只对 touchmove 和 wheel 类事件生效；touchstart 默认就不是 passive，无需额外配置
• 副作用：开启非 passive 后，滚动可能略卡顿（因浏览器无法提前优化滚动），所以建议**仅在真正需要拦截的区域启用**，而非全站监听

用 touch-action CSS 属性更轻量地禁用滑动

比起 JS 绑定事件，CSS 的 touch-action 是声明式、零运行时开销的方案，适合全局控制手势行为。

• 全屏禁用所有触控（含缩放、双指、横/纵滑）：

  html, body { touch-action: none; }

• 只禁左右滑（保留上下滚动）：

  html { touch-action: pan-y; }

  （iOS 13+ / Android Chrome 65+ 支持）
• 禁双指缩放 + 禁左右滑，但允许上下滚动：

  body { touch-action: pan-y pinch-zoom; }

  （注意：pinch-zoom 表示「允许缩放」，要禁缩放就得去掉）
• ❌ 错误认知：touch-action: none 不等于“禁 touch 事件”，它只是禁浏览器默认手势，touchstart/touchmove 仍会触发，只是没滚动/缩放效果了

只在特定区域禁滑动，避免影响页面整体体验

用户常犯的错误是「一棍子打死」：全页加 touchmove.preventDefault() 或 touch-action: none，结果导致轮播图不能滑、列表不能滚、甚至返回手势失效。

• ✅ 推荐做法：给需要拦截的容器加独立逻辑，例如轮播图外层：

  ...

  document.getElementById('carousel').addEventListener('touchmove', e => {
    const touch = e.targetTouches[0];
    const dx = Math.abs(touch.pageX - startX);
    const dy = Math.abs(touch.pageY - startY);
    if (dx > dy && dx > 10) e.preventDefault(); // 横向主导位移 > 10px 才拦截
  }, {passive: false});

• ⚠️ 关键点：必须在 touchstart 中记录 startX/startY，否则无法判断方向；阈值 10 防止误触（手指微抖也会触发）
• 不推荐用 event.cancelable === false 判断是否可拦截——它不可靠，且不同浏览器返回不一致

别忘了 viewport meta 和缩放控制，它们和触控行为强耦合

iOS 上「左滑返回」和「双指放大」本质是浏览器级交互，单靠 JS 拦截 touch 事件治标不治本，必须配合视口策略。

• 强制禁缩放（防双指）：

• ⚠️ 注意：user-scalable=no 在 iOS 10+ 已被部分限制（Safari 可能忽略），所以务必叠加 touch-action: manipulation 或 none 才稳妥
• 如果项目需支持无障碍缩放（如老年用户），请勿粗暴禁用，改用「区域级控制」：仅对 canvas、游戏画布等非文本区域禁 touch-action

真实场景中，最易被忽略的是「被动监听器」和「touch-action 作用域层级」——前者让你的 preventDefault() 完全失效，后者让你以为禁了滑动，其实只是没生效到目标元素。动手前先用 Safari Web Inspector 的「Events」面板确认事件是否真的绑定成功，比猜强十倍。