给三维与平台团队：从导出设置到小范围接入测试，把GLB交付做成可复现的流程。

GLB导出按钮点下去，工作只完成了一半。到了平台里位置偏了、图层没了、材质变黑，问题才刚开始。

接入失败大多不是格式本身，而是导出前的设置没对齐。坐标原点、单位、朝向和图层，任何一项不对都会出问题。

下面按导出前确认、导出设置、接入测试和常见问题四段说明，末段讲GLB接入能接住哪一环，哪些仍要平台团队完成。

把导出和测试做成固定流程，换一个平台或换一版底图，都能照着走一遍。

1 导出前先确认什么

1.1 目标平台与格式

先确认平台支持哪些格式，GLB是否在列表里。平台只吃特定格式，导出前就要知道，别等做完再转。

平台对文件大小、面数和贴图有没有限制，提前问清。超过限制，文件可能打不开或加载很慢。

平台是否支持多层结构，也要确认。不支持时，导出前合并图层，比接入后再拆更省事。平台是否支持压缩包上传，也影响交付方式。平台是否需要分块加载，提前问清文件切分方式。平台如果不支持透明材质，提前换成不透明。平台是否支持实例化，重复对象多时影响性能。平台对中文对象名的支持也要确认。平台如果不支持多层，导出前压成两层。

1.2 坐标单位与朝向

坐标原点按平台要求设置，不要用建模软件的默认原点。原点不对，模型会整体偏移。

单位统一到米，缩放比例检查一遍。米和毫米混用，模型会差一千倍。

朝向按平台约定核对。园区不是正南北布局时，朝向错了，叠加数据全偏。坐标轴向上的平台，导出前确认转换方式。原点和朝向写在导出说明里，接手的人能复核。坐标转换参数留档，后续文件沿用同一套。单位换算写成公式，避免手工算错。朝向偏差会随距离放大，远处更明显。导出设置存成模板，下次直接调用。

2 GLB怎么导

2.1 图层与对象选择

导出前只选需要的图层，隐藏图层和辅助对象不要带出去。无用对象会增大文件，也容易重名。

重点对象和一般对象分开检查。重点对象缺了，平台展示会缺一块；辅助对象带出去，又会干扰。

对象命名在导出前统一。平台按名称挂数据，命名混乱会增加对接工作量。隐藏对象如果有关联材质，导出前一并清理。辅助线、相机和灯光不要导出，平台会重新设置。对象层级按平台要求保留，不要全部拍平。重点对象单独导出测试，便于定位问题。对象数量按图层统计，交付时附清单。

2.2 面数与材质检查

面数超标的先简化。远处建筑用体块，近处重点建筑保留细节，不要全部精细。

材质贴图路径要打包进GLB。贴图丢失，模型进平台后会变成灰模或黑面。

透明材质和双面材质提前测试。不同平台渲染规则不同，看起来正常不代表接入后正常。贴图分辨率按平台要求控制，过大拖慢加载。面数统计按图层列出来，超标的先处理。法线方向错误的模型进平台会发黑，导出前检查。贴图丢失时先查打包设置，再查平台缓存。透明玻璃和水的渲染顺序，平台间差异较大。材质贴图大小统一，避免加载忽快忽慢。

3 接入平台怎么试

3.1 小范围先试

先拿一个片区或几栋建筑试接入，不要一次上传整城。小范围能快速定位问题。

测试至少覆盖打开、定位、图层开关和材质显示。只看能不能打开，发现不了位置和层级问题。

测试通过后再批量导出。批量文件出问题，排查范围会大很多。测试用的坐标点选在园区两个角，方便看缩放。测试文件命名带上平台和日期，避免混淆。测试通过后记录平台版本和文件版本。小范围测试通过后，再按片区逐步扩大。测试范围覆盖一栋重点建筑和一条主路。

3.2 位置与图层核对

在平台里叠加已知底图或坐标点，核对模型位置。只凭画面感觉，偏差几米也看不出来。

图层数量和名称逐个对。平台可能自动合并或重命名，接入后要确认还能按原规则找到对象。

记录测试结果和截图。下次换平台或换版本，可以对照同一套检查项。图层开关测试时逐个关，确认没有对象留在画面上。位置核对用两个已知点，单点看不出旋转偏差。图层结构在平台里截图留档，升级后能对照。位置核对记录偏差数值，别只写有偏移。接入测试结果同步给建模和平台双方。

如果要把GLB导出和平台接入的检查项固定下来，可以查看造形家官网的场景生成与编辑说明，先做小范围测试，再批量交付。

4 常见问题怎么排

4.1 位置偏移与缩放

模型整体偏移，先查坐标原点和单位，再查平台是否做了二次转换。

模型过大或过小，多半是单位设置问题。米和厘米混用，缩放会差一百倍。

朝向不对，检查导出设置和平台坐标轴约定。有的平台Y轴向上，有的Z轴向上。位置偏移先看整体，再看局部，别一上来逐个挪。缩放问题先查单位，再查导出比例。旋转偏差用指北针或已知道路核对。偏移如果所有对象一致，优先查原点。缩放正确但位置偏，先查坐标转换。位置问题先看整体偏移，再看个别对象。

4.2 材质丢失与重名

材质变黑或变灰，先查贴图是否打包，再查平台是否支持该材质类型。

对象重名会导致挂接错位。导出前用脚本查重名，比在平台里逐个找快。

图层被合并时，确认平台规则。必要时在导出前把关键对象单独成层，减少被合并的影响。材质问题记录软件和平台版本，换环境可能不同。重名检查在导出前做，平台里改起来很慢。材质贴图路径用相对路径，换电脑也能找到。材质名称和对象名称不要混用同一套规则。重名对象加后缀区分，别直接删掉。问题解决后更新测试记录，别只口头说好了。测试记录附截图，复测时好对照。

5 GLB接入能接哪几环

5.1 导出场景生成

造形家官网展示了地图框选生成三维场地模型、AI 识别建筑轮廓高度和类型、生成地形水体和植被等能力，也支持图层化预览、编辑和管理。

底图可以按片区生成，建筑、道路、地形、水体和绿化一起带入，导出前在场景里按图层检查。

建筑类型、位置、旋转和高度可以调整，识别结果能人工修正。导出前把明显错误先改掉。

地形和水体分层显示，河道、坡地和低洼区更容易核对。位置关系不对，导出后只会更难看。

图层化预览让导出范围可控。只选需要的图层，减少无用对象和重名。导出前的图层检查在场景里完成，缺项和重名能直接看到。场景里的对象名称和导出文件保持一致，平台挂接少一步。

几个片区可以分别导出，在平台里按同一坐标拼接。接边位置的问题更容易定位。

平台开发、材质优化和性能调优不在导出环节完成。GLB只是交付格式，不替代平台侧工作。

整理完可以导出通用 GLB，接到山海鲸可视化、GISBox、Unity、Unreal Engine 或 Blender。

5.2 平台侧配合

平台团队负责接入配置、权限和性能优化。三维团队负责文件本身正确，两边责任要分清。

接入问题按位置、图层、材质三类记录。混在一起描述，排查会很慢。

每次平台升级后重测一次。升级可能改变坐标轴或图层规则，旧文件未必还能直接用。交付文件按平台和片区命名，接入时不用猜。每次导出附一页设置说明，下一次能复现。

这类流程适合三维底图导出与接入测试，造形家不承担平台开发与运维。边界在交付说明里写清。

6 把GLB交付做成可复现的流程

6.1 目标先问

目标先问。平台支持什么格式、多大文件、几层结构，导出前确认，后面少返工。

6.2 导出分层

导出分层。只选需要的图层，重点对象和辅助对象分开，重名和冗余能少很多。

6.3 小范围试

小范围试。先接一个片区，检查位置、图层和材质，通过后再批量导出。

6.4 问题留单

问题留单。位置、缩放、材质和重名分类记录，下次遇到能直接对照。

6.5 版本随导出

版本随导出。每次导出留编号和日期，平台接入出问题时知道是哪一版。

FAQ：常见问题

FAQ-1 导出的文件打不开怎么办？

先确认平台是否支持GLB，再检查文件大小和面数是否超限。还打不开，用另一个软件试开，判断是文件问题还是平台问题。

FAQ-2 GLB能带属性吗？

GLB主要承载几何和材质，业务属性通常要由平台侧另行挂接。对象编码和名称要提前整理，方便平台匹配。

FAQ-3 平台要其他格式怎么办？

先确认平台支持的格式清单，再用中间软件转换。转换后必须重新检查单位、坐标和图层，不能默认无损。

需要把导出设置、测试记录和问题清单整理成一套，可以查看造形家官网的场景生成与编辑说明，按平台归档后再交给接入团队。

【内容与技术说明】
本文由造形家产品团队整理发布，内容由AI工具辅助生成并经团队人工核验。
因产品版本持续迭代，具体功能、参数与免费范围以造形家官方文档为准。
如有技术疑问或内容勘误，欢迎通过support@shapezo.com反馈。
最后核校：【2026-10-26】。