substance 3d stager 抓不到模型

Question

Accepted Answer

确认模型是否真的进入了场景
导入模型后，先看左侧或界面中的场景层级列表，而不是只盯着视口看。如果列表里没有新增条目，说明导入动作本身没成功，问题出在文件选择或格式上；如果列表里已经出现模型名称但视口里看不到，说明模型已经在场景里，只是位置、缩放或可见性有问题。这两种情况的处理方向完全不同，先分清能省很多时间。可以尝试重新执行一次导入，观察导入过程中是否弹出提示，提示内容往往能说明是文件无法解析还是路径读取失败。
检查导入格式与文件本身是否可用
Substance 3D Stager 对导入的模型格式有要求，常用的有 obj、fbx、gltf、glb、usd 等，具体支持范围以你当前版本为准。如果文件扩展名看起来对但依然抓不到，先用系统里的其他三维查看工具打开同一文件，确认文件本身没有损坏、不是空壳、也不只是压缩包改后缀。obj 要连同 mtl 和贴图一起确认，fbx 要确认导出时勾选了网格与材质，glb 或 gltf 要确认是完整导出而非残缺分片。若文件本身在其他软件里也打不开，就不是 Stager 的问题。
排查模型是否跑到视口外或被缩得看不见
导入后模型可能因为原点偏移、单位不一致或导出时的缩放设置，被放到离相机很远的位置，或者小到只有几个像素。可以先用视图里的整体适应或框选全部功能，让相机自动对准场景里的所有对象；再用移动工具查看场景里是否存在一个数值异常大的坐标。很多 fbx 从其他软件导出时会带上厘米与米之间的换算差异，导致模型看上去消失。把对象坐标归零、重新设定一个合理缩放值，通常就能让模型重新出现在画面中。
检查可见性、图层与选择状态
如果场景列表里有模型，但视口里仍然抓不到，逐项检查可见性开关：对象是否被隐藏、所在的父级组是否被关闭显示、是否被放进了当前不可见的图层或集合。还要看对象是否被锁定，锁定后虽然看得见但无法被选中或移动，容易被误认为抓不到。可以先把所有对象取消隐藏、解除锁定，再单独选中目标对象，用局部框选确认它的包围盒是否真实存在。如果包围盒存在而画面空白，多半是材质或渲染显示模式的问题。
确认当前编辑模式与相机视角
Stager 的视口有不同显示与操控状态，若当前处于某个特定工具或相机视角中，可能会对选择范围产生限制，导致看起来抓不到模型。可以切换到默认的选择工具，重置相机到透视视角，再尝试点击或框选对象。若使用窄角度相机或正交视图，模型在画面边缘时也不容易点中，先缩小视野、拉远镜头再选。选中后确认属性面板是否显示了该对象的参数，面板有数据就说明抓取成功，问题只是显示或视角造成的错觉。
仍然抓不到时的处理顺序
按以下顺序逐项确认：文件本身能被其他软件打开、导入时选择的是受支持的格式、场景列表出现对应条目、对象没有被隐藏或锁定、对象坐标与缩放处于合理范围、当前使用的是选择工具且相机视角正常。每一步都记录看到的现象，就能判断问题卡在哪一环。如果所有检查都通过、模型依然不出现，可以换一个简单的测试模型再导入一次，用对照的方式判断是文件问题还是软件当前状态问题；也可以到软件页查看该版本的说明与已知注意事项，链接为 https://www.xxu5.com/?p=3048 。