跳到主要内容

故障排查

编辑器无法启动​

编辑器要求 WebGPU。若显示“SuperSplat requires WebGPU, which this browser does not support”，改用新版 Chrome、Edge、Safari 26+ 或启用 WebGPU 的 Firefox，确认硬件加速开启。多 GPU 机器需允许浏览器使用独立显卡。

若为“SuperSplat failed to start”，查看控制台并在报告中附上详情。

无法导入​

  • 确认属于支持格式。只含网格或点云的普通 PLY 不可用，需要含 xyz、scale_*、rot_*、opacity、f_dc_* 和可选 f_rest_* 的 3DGS PLY，参见区别。
  • 多文件格式拖入父目录，保留相对路径。
  • URL 导入的服务器必须允许 CORS。
  • 内存不足时降低源细节、关闭其他 GPU 密集标签，分别导入。

选择与可见表面不匹配​

检查底部左侧两个开关：

  • **Selection Depth（N）**默认关，选择穿透全场景，包含表面后方隐藏单元。开启只选可见表面。
  • **Selection Footprint（M）**默认关，只有中心在形状内才命中，中心略在外的大型柔和单元不选。开启按完整覆盖范围。

Tab 仅切换中心和环叠加，不改选择规则。锁定或删除单元不可选，按需 Select > Unlock 或 Reset。

参见深度与覆盖和清理技巧。

变换影响了错误内容​

有选择时，移动、旋转、缩放及数值 Transform 只影响选择。Select > None 后变换整个活动项。

绕错误点旋转或缩放时，切换原点控制，或双击表面放轴心，参见变换测量对齐。

导出缺少内容​

只导出可见数据，打开所有需要项的眼睛，关闭 Solo 并检查整体。

合并用 File > Export > PLY；File > Save 是可编辑项目。

颜色不同​

  • 检查 Preferences 色调映射和球谐阶数，Appearance 背景。这些视图设置不写入数据导出。
  • 展开 Colors，Reset 排除整体或选择调色。
  • 多角度检查，球谐颜色与视角有关。

数据调整和视口设置区别见颜色外观。

缓慢或内存不足​

大型数据受显存限制。关闭图形密集标签，Solo 一次处理一个，导入多 LOD 时选粗层，清理减少数量。序列每帧都是完整数据，也占大量内存。

环绕大场景卡顿时，检查 Preferences 的 Stochastic Alpha。默认 Auto 检测慢排序帧后在移动时用随机渲染；Movement 每次移动都用；Enabled 始终用。Overlays 的 Frame Timings 与 Overdraw 显示瓶颈：高 GPU 耗时加红白热图说明重叠多，可清理或降 LOD。

未保存或项目混淆​

经常 File > Save 或 Save As 保留 .ssproj。要继续布局、相机或动画，PLY 等交付格式不能替代项目文件。

保存、打开、导入、导出区别见项目管理。

发布或渲染失败​

  • 发布需登录账号。
  • 视频编码取决于浏览器，对话框会禁用当前设置下无法编码的分辨率。降低分辨率、帧率、码率，换格式或编码，或更新浏览器与驱动。
  • 下载阻止、隐私模式限制或内存不足可能让大型渲染导出失败。不支持文件系统 API 的浏览器通过下载交付。

报告问题​

仍有问题时，Help > Log an Issue，附浏览器版本、系统、格式、约单元数与复现步骤，也可询问 Discord 社区。