老旧Mac机型因GPU驱动陈旧、Metal支持不完整或WebGL初始化失败，导致Three.js等应用白屏或报错；需确认GPU型号、关闭系统GPU降级策略、强制启用WebGL 1.0并清除缓存与网站数据。
老旧Mac机型（如2012–2015年款MacBook Pro、iMac）在运行较新版本macOS和Safari时，常因GPU驱动陈旧、Metal支持不完整或WebGL上下文初始化失败，导致Three.js、Babylon.js等应用白屏、报错“WebGL not supported”或渲染卡死。这类问题无法靠单纯更新浏览器解决，需针对性绕过硬件限制与系统策略冲突。
确认GPU型号与WebGL兼容性基线
第一步：点击左上角苹果图标 → “关于本机”，查看“图形卡”型号（例如：Intel HD Graphics 4000 / NVIDIA GeForce GT 650M）。【Intel HD 4000及更早集成显卡、NVIDIA GT 6xx系列显卡在macOS Monterey及以上已失去官方WebGL 2.0支持】。
第二步：打开终端，执行命令：system_profiler SPDisplaysDataType | grep -E "(Chip|Model|VRAM)"，确认显存是否≥512MB且驱动未被标记为“已弃用”。若输出含“Deprecated”字样，说明系统已禁用该GPU的Metal加速路径。
第三步：访问 https://www.php.cn/link/dfaf0f333b6b70de28eaf291774d94db，若显示红色“Your browser does not support WebGL”，则进入下一步；若显示绿色但3D应用仍异常，跳至“强制启用WebGL 1.0回退模式”小节。
关闭系统级GPU降级策略
macOS Ventura/Sonoma对老旧GPU默认启用软件回退渲染，会主动屏蔽WebGL硬件上下文。必须手动干预：
1、打开“系统设置” → “辅助功能” → “显示”，关闭【减少动态效果】和【降低透明度】——这两项会强制禁用Metal合成器，使WebGL降级为CPU软渲染，帧率低于5fps。
2、进入“系统设置” → “电池” → “选项”，将“自动切换图形处理器”设为【始终使用高性能图形处理器】（仅限双GPU机型）；若为单GPU机型，此选项不可见，跳过。
3、重启Mac——这一步不可跳过，因为GPU策略在内核启动时加载，仅重启Safari无效。
强制启用WebGL 1.0回退模式
当WebGL 2.0因驱动缺失失败时，Safari仍可启用兼容的WebGL 1.0核心规范。需绕过UI限制写入底层偏好：
方法一：终端强制启用基础WebGL栈
打开“终端”，依次执行：
defaults write com.apple.Safari WebKitWebGLEnabled -bool true
defaults write com.apple.Safari WebKitWebGL2Enabled -bool false
defaults write com.apple.Safari WebKitAccelerated2DCanvasEnabled -bool true
执行后完全退出Safari（Command + Q），再重新启动。
方法二：禁用实验性功能干扰
若已开启过“调试”菜单或启用过内部开发选项，残留配置可能覆盖WebGL行为。执行：defaults delete com.apple.Safari IncludeInternalDebugMenu → 再次重启Safari。
清除GPU缓存与网站策略冲突
老旧机型长期运行易积累损坏的Shader缓存或错误的站点权限策略，导致 createContext() 返回 null：
第一步：Safari菜单 → “清除历史记录与网站数据” → 选择“所有历史记录” → 点击“清除历史记录”。
第二步：进入“偏好设置” → “隐私” → “管理网站数据”，按“大小”排序，找到 threejs.org、webglsamples.org、babylonjs.com 等条目，逐个选中 → “移除”。
第三步：终端执行彻底清空GPU着色器缓存：rm -rf ~/Library/Caches/com.apple.Safari/WebKit* && rm -rf ~/Library/Caches/com.apple.WebKit*。
第四步：重启Safari，访问 https://www.php.cn/link/aaf68231a75ec5beb026ac75a088cf16，确认“WebGL 1.0”状态为“Available”，且“Renderer”字段显示实际GPU型号（非“Software Rasterizer”）。
