火狐浏览器macOS多指触控缩放失效修复方法

先说结论：火狐浏览器在 macOS 系统下双指缩放失灵，这一问题多半出现在系统更新或浏览器升级之后，原因是触控板手势映射断开了。具体症状十分明显：页面无法通过双指开合放大缩小，但滚动功能依然正常。这说明 WebKit 层的事件传递没有问题，问题在于 APZ 缩放管线根本没有被激活。

先确认系统设置是否开启关键开关

打开「系统设置 → 触控板 → 滚动与缩放」，检查「缩放：双指开合」选项是否为开启状态。macOS 14 及以上版本中，这个开关默认是关闭的，如果不手动打开，Firefox 就无法接收到原始的 pinch 事件流。

同时建议检查「滚动方向：自然」是否已开启。如果关闭，Firefox 很可能将反向的缩放指令当作无效手势直接丢弃——这也是很多用户在系统升级后缩放失效的真正原因。

在 Firefox 内部开启缩放手势识别模块

在地址栏输入 about:config，回车，点击“接受风险并继续”。

搜索 apz.gtk.touchpad_pinch_enabled，双击将其设为 true。这个参数是 Firefox macOS 版的专属配置，控制着 IOHIDEvent 中的 pinch 事件能否顺利进入 APZ 缩放处理队列——简单来说，它就是缩放功能的“入口闸门”。

注意：如果搜不到这个项，可以右键空白处 → 新建 → 布尔值，名称填写 apz.gtk.touchpad_pinch_enabled，值设为 true。

接着搜索 apz.allow_zooming，确认其值为 true。这个参数一旦被设为 false，整个 APZ 缩放、滑动、惯性滚动管线都会被硬性禁用——后果是所有多指手势都会失效，不只是缩放。

重置 Firefox 对触控板事件的优先级绑定

先说步骤，再做说明：

第一步：关闭所有 Firefox 窗口。

第二步：打开终端，执行以下命令——
defaults write org.mozilla.firefox AppleEnableSwipeNavigateWithScrolls -bool true

第三步：再执行一条关键命令，强制刷新触控板事件路由表——
defaults write org.mozilla.firefox AppleEnablePinchZoom -bool true

第四步：重启 Firefox。如果不重启，新写入的 Bundle ID 偏好设置不会加载进 Gecko 主线程。

为什么这两条命令缺一不可？因为 macOS 系统底层将滑动导航和缩放分成了两个独立的事件通道：前者负责滑动导航，后者专管缩放。这个拆分设计本身合理，但在出问题时容易让人摸不着头脑。

最后别忘了排除 Reader View 的干扰

在网页上按下 Cmd+Alt+R 退出 Reader View 模式。这个模式会劫持所有多指手势，并重新映射为翻页操作——结果就是双指开合完全无反应。即使系统和 about:config 全部设置正确，只要 Reader View 处于开启状态，缩放必然失效。这可以说是一个最容易被忽略的“隐藏杀手”。