ipad上用html5加载gltf模型必须使用webgl 2.0环境，safari（ios 15.4+）已默认启用，但需显式初始化three.webglrenderer并验证renderer.capabilities.iswebgl2为true；必须用r137+的three.gltfloader加载.glb格式模型；file://协议被禁止，须通过本地http服务（如python3 -m http.server）访问；纹理路径问题可通过全封装.glb规避；性能优化需控制纹理尺寸≤2048×2048、骨骼数≤32、关闭阴影。
iPad上用HTML5加载glTF模型必须用WebGL 2.0环境
原生Safari在iPad（iOS 15.4+）已默认启用WebGL2，但不支持WebGL1下运行的旧版Three.js r128及更早版本的glTF加载器。如果你看到黑屏、TypeError: undefined is not an object (evaluating 'renderer.extensions.get') 或控制台报WEBGL_depth_texture不可用，基本就是渲染上下文没切到WebGL2。
实操要点：
- 初始化
THREE.WebGLRenderer时显式传入{ antialias: true, powerPreference: "high-performance", stencil: true }，并检查renderer.capabilities.isWebGL2是否为true - 加载glTF必须用
THREE.GLTFLoader（非JSONLoader或OBJLoader），且版本不低于r137 - 模型文件必须是
.glb（二进制格式），.gltf（JSON+外部bin/texture）在iOS Safari中容易因跨域或路径解析失败而静默失败
本地HTML文件在iPad上无法直接读取模型文件
iPad的Safari禁止file://协议下的XMLHttpRequest或fetch()读取同目录下的.glb——这是CORS和沙箱策略双重限制，不是代码写错了。你双击打开index.html，控制台大概率看到Failed to load resource: Frame load interrupted或net::ERR_FILE_NOT_FOUND。
绕过方法只有两个：
立即学习“前端免费学习笔记（深入）”；
- 用Python快速起一个本地服务：
python3 -m http.server 8000
然后在iPad Safari里访问http://[Mac-IP]:8000 - 用iOS端支持本地HTTP服务的App，比如「DraftCode」或「Koder」，它们内置轻量服务器，可直接预览项目目录
- 绝对不要尝试用
blob:URL或URL.createObjectURL()手动载入文件——iPad Safari对Blob URL的生命周期管理极不稳定，模型常加载一半就销毁
纹理贴图路径错误导致模型变紫或纯色
glTF规范要求纹理路径写在.gltf JSON里，但iOS Safari对相对路径解析异常严格：如果HTML在/project/index.html，而model.gltf里写"uri": "textures/baseColor.png"，它会尝试从/project/textures/找；但若你用file://协议或服务根路径不对，实际请求地址会变成/textures/...（少了一级），结果404。
稳妥做法：
- 全部使用
.glb封装格式——纹理、几何、动画全打包进一个二进制文件，彻底规避路径问题 - 若必须用
.gltf，确保Web服务器将模型与纹理放在同一级目录，并在gltf中用"uri": "baseColor.png"（无子目录） - 加载前加日志：
loader.load('model.glb', (gltf) => { console.log(gltf.scene); }, undefined, (err) => console.error(err));，错误对象err里通常含具体404路径
iPad性能瓶颈集中在纹理尺寸和骨骼数量
哪怕A14芯片，在Safari中渲染带PBR材质的glTF也极易掉帧。常见卡顿不是因为模型面数高，而是：
- 单张贴图超过
2048×2048像素——iOS Safari对TEXTURE_MAX_SIZE硬限制为4096，但超过2048就会触发CPU缩放，严重拖慢首帧 - 骨骼数量＞32根（尤其蒙皮网格）——WebGL2虽支持更多
MAX_BONES，但Safari驱动层对UNIFORM_BLOCK更新效率低，动画一动就10–15fps - 未关闭
renderer.shadowMap.enabled = false——iPad默认不支持PCFSoftShadowMap，开阴影等于强制退化到BasicShadowMap，且每帧多一次全场景绘制
导出模型时用gltf-pipeline压缩：
gltf-pipeline -i model.gltf -o model.glb --draco.compressMeshes --textureSize 2048，比手动调参数更可靠。
