iOS Safari运行HTML5小游戏失败主因是特性禁用或WebKit拦截：fetch/WS在旧系统有bug、WebGL上下文创建敏感、触摸事件被延迟、AudioContext需用户手势触发，真机调试最有效。
HTML5小游戏在iOS Safari打不开，绝大多数情况不是“不支持HTML5”，而是特定特性被禁用、未转译、或触发了WebKit内核的渲染/执行拦截机制——尤其是iOS 12以下旧系统，或启用了严格隐私策略的新设备。
fetch或WebSocket连接直接失败（白屏/卡在loading）
旧版iOS Safari（iOS 9–10.2）的fetch存在严重bug：POST带body时静默卡死；WebSocket在页面后台化后常被强制断连；且Safari默认阻止非HTTPS页面的WebSocket连接（即使localhost也不行）。
- 必须为所有
fetch请求显式添加headers: { 'Content-Type': 'application/json' }，否则iOS 9–10.2直接不发请求 - 用
whatwg-fetchpolyfill仅解决语法问题，不修复底层bug；建议对关键请求降级为XMLHttpRequest - 本地调试时，确保服务走HTTPS（或
http://localhost），否则WebSocket会被Safari静默拒绝，控制台无报错 - iOS 15+ 若开启“隐藏IP地址”或“阻止跨网站跟踪”，可能中断游戏服务器心跳包——临时关闭这些设置可快速验证
Canvas渲染空白或黑屏（但JS逻辑正常运行）
iOS Safari对<canvas></canvas>的WebGL上下文创建极为敏感：GPU内存超限、抗锯齿开关、高DPR缩放未适配、甚至canvas.width/height设为小数，都会导致getContext('webgl')返回null，且不抛异常。
- 初始化前务必检查：
const gl = canvas.getContext('webgl') || canvas.getContext('experimental-webgl');，不能只写'webgl' - 避免动态设置
canvas.width为window.innerWidth * window.devicePixelRatio——iOS会四舍五入出错；改用Math.floor()强制取整 - 禁用
antialias: true（尤其在iOS 14–15），部分A12/A13芯片设备开启后Canvas全黑 - 若用PixiJS或Three.js，确认版本≥6.5（修复了iOS 16.4+的
drawArrays崩溃）
触摸事件失效或响应延迟（点不动、拖拽卡顿）
iOS Safari为优化滚动性能，默认对touchstart/touchmove事件施加300ms延迟，并在非scrollable区域禁用preventDefault()——这对需要高频触控的小游戏是致命的。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
立即学习“前端免费学习笔记（深入）”；
- 必须在
中声明：<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no, viewport-fit=cover">，缺user-scalable=no会导致touch事件被劫持 - 所有触控监听需加
{ passive: false }，并在touchstart里立刻调用e.preventDefault()（iOS 13+要求显式声明passive） - 避免在
touchmove里做重计算（如实时路径追踪），iOS会降频执行；改用requestAnimationFrame节流 - 真机测试时，关闭“辅助功能→指针控制→触控调节”，该开关会全局抑制
touchend事件
AudioContext无法播放音效（静音/报错InvalidStateError）
iOS Safari强制要求音频必须由用户手势（click/touchend）触发才能解封AudioContext，且一旦挂起就不可恢复——这是最隐蔽也最容易被忽略的兼容点。
- 不能在
onload或setTimeout里初始化AudioContext；必须绑定到第一个用户交互事件，例如document.body.addEventListener('touchend', initAudio, { once: true }) - 使用
new Audio()播放短音效更可靠，但注意iOS对audio.play()返回Promise，需.catch(e => console.warn('audio play failed:', e))捕获静音状态 - 避免同时创建多个
AudioContext实例（iOS 15+限制为1个），统一管理并复用 - 若用Howler.js，确保版本≥2.2.4，并启用
html5: true选项绕过Web Audio API限制
真正棘手的从来不是“哪个API不支持”，而是iOS Safari把一堆合理行为当异常处理——比如把localStorage写入失败静默吞掉、把Canvas尺寸小数转成0、把未标记crossorigin的图片当成跨域拒绝绘制。真机连Mac Safari远程调试器看Console和Network，比查兼容表管用十倍。
