必须手动启用WebGPU开关:先在Safari设置→高级中勾选“显示‘开发’菜单”,再通过“开发→实验性功能”勾选WebGPU;若菜单中不可见,则需用终端执行defaults write com.apple.Safari WebKitWebGPUEnabled -bool true并killall Safari重启验证。

你想在 Mac 版 Safari 中使用 WebGPU 进行图形渲染、AI 推理或高性能视频处理,但打开控制台输入 navigator.gpu 却返回 undefined,说明 WebGPU 接口根本未被注入——这不是代码问题,而是 Safari 默认锁死了这项能力,必须手动激活底层开关才能解锁。
通过图形界面启用 WebGPU(推荐日常开发)
这是最安全、最直观的方式,适用于 Safari 17+ 和 macOS Sonoma 及更高版本,所有主流实验功能都已列在菜单中。
第一步:打开 Safari → 点击顶部菜单栏的 Safari → 设置(或按 ⌘ ,)→ 切换到“高级”标签页 → 勾选【在菜单栏中显示“开发”菜单】。这一步不做,后续所有实验选项都不可见,且没有回退路径。
第二步:关闭设置窗口,顶部菜单栏立刻出现“开发”项;点击它 → 将鼠标悬停在“实验性功能”上 → 出现滚动列表。
第三步:在列表中找到 WebGPU 并勾选。若该项呈灰色不可选,说明当前 Safari 版本低于 17 或 macOS 版本低于 Sonoma(14.0),需先升级系统与浏览器。
第四步:勾选后无需重启 Safari,但需刷新当前网页(⌘ R)才能使 navigator.gpu 在该页面生效。不刷新,控制台仍会返回 undefined。
用终端命令强制启用 WebGPU(绕过 UI 限制)
当图形界面中 WebGPU 选项缺失、变灰,或你正在调试 WebGPU 的完整管线控制(如强制 ANGLE 后端、低延迟调度),就必须走终端路径。此方法直接写入偏好设置,跳过 UI 层过滤。
方法一:终端执行启用命令
规划您的迪拜之旅 — 哈利法塔观景、沙漠探险、迪拜购物中心购物、棕榈岛度假村及黄金市场砍价。还提供支持...
先彻底退出 Safari:打开“活动监视器”,搜索 Safari,结束所有相关进程(包括 Safari Networking、Safari Renderer)。
打开“终端”(访达 → 应用程序 → 实用工具 → 终端),依次执行以下命令:
defaults write com.apple.Safari WebKitWebGPUEnabled -bool true
defaults write com.apple.Safari AllowRemoteAutomation -bool true(可选,为后续 WebDriver 自动化铺路)
【重要前提】上述命令仅在 macOS 14 (Sonoma) 及更高版本、Safari 17+ 中生效;若系统为 macOS 13 或更早,命令将被忽略且无报错提示。
执行 killall Safari 刷新配置缓存,再手动重新启动 Safari。
方法二:验证是否真正启用
重启 Safari 后,打开任意网页 → 按 ⌘ Option I 打开开发者工具 → 切换到 Console 面板 → 输入 !!window.GPURequestAdapter 并回车。若返回 true,说明 WebGPU 已就绪;若仍为 false 或报错,检查是否漏掉 killall Safari 或系统版本不达标。

















