AI 生成的 Three.js 场景空白?按顺序排查
2026年10月23日
Prompt Style Atlas 编辑组
重写动效提示词前,依次检查控制台错误、依赖、画布尺寸、相机取景和渲染。
浏览器里只有空白画布,不足以诊断生成项目。先确认哪些内容加载成功、哪些步骤失败。本文提供排查流程,不代表本站已经测试每个展示项目,也不承诺某一个改动能修复所有空白场景。
1. 先看第一条错误
打开浏览器开发者工具并重新加载,复制最早相关错误的文件名和行号。后续报错可能只是连带结果。把错误与相关文件交给编程助手,而不只是说“动画不能用”。分享日志前移除密钥与私人数据。
2. 确认项目如何运行
按项目说明启动,确认是否需要开发服务器或构建步骤,检查依赖和文件是否存在。素材请求失败时先检查路径,不要马上重写整个场景。在需求中明确列出缺失输入。
3. 检查画布与取景
确认画布可见、尺寸不为零,也没有被其他元素盖住。把场景缩减为简单材质的可见物体与朝向它的相机。先排查裁剪、位置和比例,再恢复复杂灯光与后期效果。
4. 检查渲染路径
找到渲染场景的代码。静态物体至少需要一次渲染,动画则需要实际运行的更新路径。要求助手解释哪个函数更新物体、哪个函数渲染、这些函数在哪里调用,再对照项目检查。
5. 逐项恢复效果
简单场景正常后,分别恢复素材、材质、灯光、效果和交互。如果某一步后变空白,问题范围已经缩小。检查新错误和改动要求,不要再次重写所有提示词。
更具体的修复请求
项目应该展示[预期结果],实际展示[观察结果]。
最早相关控制台错误为[错误、文件和行号]。
仍能复现问题的最小场景是[相关代码或文件]。
保留现有依赖版本。解释原因,做针对性修复,
并说明如何在缩放窗口和移动端检查结果。
只分享有权公开的代码与日志,不要在修复请求中放入凭证。记录改动与观察结果,避免后续编辑再次引入问题。
先阅读代码动效与生成式视频的区别,再浏览 Three.js 参考案例。预览用于参考;来源文字可能不完整,以页面标识为准。