VM00—05
Loading environment
3D 文件格式
从 Blender 正确导出 USDZ 与 USDC 材质和法线
整理 Principled 材质、法线、变换与打包，获得更可靠的往返结果。
从 Blender 正确导出 USDZ 与 USDC 材质和法线
USD 导出问题通常来自不支持的着色节点、无效法线、未使用材质槽或过强置换。相比复杂渲染网络，受控的交换材质往往更可靠。 本手册把操作、原理与验收证据放在同一条制作链上。目标不是记忆一组菜单，而是让另一位制作者在相同输入下得到相同结论，并指出版本边界、失败位置与恢复路径。
适用版本与验证边界
用 Blender 5.2.0 LTS 上的 EasyExport 2.0.2 验证。USDZ Lightweight Review 预设导出选择对象，排除灯光、相机与绑定，贴图限制为 2048 px，并保留源拓扑以稳定切线。 文中“通过”只代表所写条件在该版本、仓库实现或指定目标得到验证；它不表示任意第三方插件、导出器或查看器都会保留相同能力。Easy 系列结论同时依据清单、仓库源码、单元测试和 Blender 5.2 烟雾测试。
最终目标
USD 导出问题通常来自不支持的着色节点、无效法线、未使用材质槽或过强置换。相比复杂渲染网络，受控的交换材质往往更可靠。 最终交付不只是一张漂亮图片或一个能打开的文件，还必须包含可重放步骤、阶段门槛、诊断记录、依赖清单与目标端证据。任何无法在洁净环境复现的成功，都暂时视为缓存或本机状态造成的偶然结果。
图 1：最终成果。这是“从 Blender 正确导出 USDZ 与 USDC 材质和法线”流程中的无文字视觉检查点。
准备条件
带单位、尺寸或来源说明的代表输入，以及一个明确失败对照
未覆盖的高质量源文件和只用于诊断、交换、交付的独立副本
记录完整 Blender、Easy 扩展、导出器与目标查看器版本
可写暂存目录、依赖清单、目标验收矩阵和回退点
中性测试灯光、近景诊断相机与最终交付相机
开始“从 Blender 正确导出 USDZ 与 USDC 材质和法线”前复制源文件，并为关键输入计算哈希。把系统、版本、目标格式、查看器和案例预算写入同一记录。这样出现差异时可以判断是内容、工具还是环境变化，不会在多个变量同时移动时猜测。
图 3：准备阶段。这是“从 Blender 正确导出 USDZ 与 USDC 材质和法线”流程中的无文字视觉检查点。核心概念
原则 1： 交换材质使用受支持的 Principled BSDF 路径。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 2： 自动移除未分配给任何面的材质槽，不应直接报错。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 3： 默认不要导出破坏性置换连接。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 4： 有目的地应用或保留变换。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 5： 清除无效自定义分裂法线，再一致地重算法线。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
原则 6： 在 Blender 和真实交付查看器中都检查导出文件。 该原则必须对应可观察信号与失败回退点；只有“看起来更好”而没有测量或受控对比，不能作为制作门槛。
图 2：制作背景。这是“从 Blender 正确导出 USDZ 与 USDC 材质和法线”流程中的无文字视觉检查点。真实制作案例
案例 0.72 m 椅子有五个材质槽，其中两个未用，并含程序织物和 4 mm 置换。交换副本烘焙织物，保留基础色、金属度、粗糙度与切线法线，删除证实未用槽，以克制 Bump 替代置换，导出 2K 贴图并对照中性源渲染。 该案例刻意保留失败对照，用来区分流程真实正确与结果碰巧可用。所有数值只是本案例验收条件；移植到其他项目时，应根据镜头距离、目标硬件、许可与交付格式重新制定，而不是机械复制。
完整操作流程
下图把“从 Blender 正确导出 USDZ 与 USDC 材质和法线”的八个阶段和各自门槛连成闭环。箭头表达依赖关系，不意味着流程永远只能线性前进；诊断推翻上游假设时，应回到拥有该变量的最早阶段，修复后重新执行全部后续门槛。
技术图 1：从 Blender 正确导出 USDZ 与 USDC 材质和法线的阶段门槛流程。阶段 1 — 最终成果
执行动作。 冻结验收目标：USD 导出问题通常来自不支持的着色节点、无效法线、未使用材质槽或过强置换。相比复杂渲染网络，受控的交换材质往往更可靠。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 选择对象或命名集合防止辅助物泄漏 本阶段遵循的原则是：交换材质使用受支持的 Principled BSDF 路径。 在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 先固定输入基线，再讨论处理结果。“选择对象或命名集合防止辅助物泄漏”是本阶段的事实锚点；若基线不可信，后续差异无法归因。用未修改样本与工作副本做同条件对照，只记录由本阶段引入的变化。
阶段门槛。 通过条件是 所有实际面都有材质。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：因为存在未使用材质槽就拒绝导出，会制造不必要的手工清理。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
阶段 2 — 制作背景
执行动作。 复制场景或建立专门导出视图层，避免改变最终渲染材质。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 只删除分配审计证明未用的材质槽 本阶段遵循的原则是：自动移除未分配给任何面的材质槽，不应直接报错。 在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 结构错误常被漂亮外观暂时遮住。“只删除分配审计证明未用的材质槽”把结构关系变成可检查条件。先在大纲、数据块或目录层验证归属，再进入视觉判断；否则下游修饰会扩大返工范围。
阶段门槛。 通过条件是 未使用材质槽自动移除。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：交换时把高度连接到置换，可能导致模型严重变形。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
图 4：核心操作。这是“从 Blender 正确导出 USDZ 与 USDC 材质和法线”流程中的无文字视觉检查点。阶段 3 — 准备阶段
执行动作。 移除没有分配给任何多边形的材质槽。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 交换材质优先使用支持的 Principled 通道 本阶段遵循的原则是：默认不要导出破坏性置换连接。 在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 准备阶段要把隐含状态转成显式记录。“交换材质优先使用支持的 Principled 通道”决定后续操作所依赖的坐标、路径或解释方式。保存修改前后的数值，并让洁净样本复现同一前提。
阶段门槛。 通过条件是 没有意外置换连接。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：把 OpenGL 改为 DirectX 不能替代修复网格法线。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
阶段 4 — 核心操作
执行动作。 建立交换安全的 Principled 网络，包括基础色、粗糙度、金属度、必要透明度和已验证法线。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 烘焙程序化与渲染器专用效果 本阶段遵循的原则是：有目的地应用或保留变换。 在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 核心操作必须保持单变量。“烘焙程序化与渲染器专用效果”是这一轮唯一允许移动的控制量；相机、曝光、缓存和无关节点保持不变。若结果随它可重复变化，因果解释才成立。
阶段门槛。 通过条件是 法线约定正确。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：文件成功写出不代表目标支持所有着色节点。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
图 5：关键细节。这是“从 Blender 正确导出 USDZ 与 USDC 材质和法线”流程中的无文字视觉检查点。阶段 5 — 关键细节
执行动作。 除非目标明确支持所需方式，否则断开置换。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 移除不支持置换或转换为克制 Bump 本阶段遵循的原则是：清除无效自定义分裂法线，再一致地重算法线。 在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 关键细节通常出现在边界而非正面视图。“移除不支持置换或转换为克制 Bump”需要在近景、掠射角或层级边界复核。把局部证据与最终镜头并列，避免只优化某一个观察距离。
阶段门槛。 通过条件是 自定义法线有效或已清除。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：因为存在未使用材质槽就拒绝导出，会制造不必要的手工清理。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
阶段 6 — 正确与错误对比
执行动作。 处理负缩放，检查平滑，清除错误自定义法线并统一重算。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 在临时副本诊断负缩放与分裂法线 本阶段遵循的原则是：在 Blender 和真实交付查看器中都检查导出文件。 在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 正确与错误对照必须共享输入。“在临时副本诊断负缩放与分裂法线”之外的条件全部锁定，再保存同角度、同曝光、同查看器结果。这样评审者看到的是规则差异，而不是两套场景的偶然差别。
阶段门槛。 通过条件是 重新导入的尺度与方向一致。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：交换时把高度连接到置换，可能导致模型严重变形。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
阶段 7 — 诊断过程
执行动作。 先导出 USDC 检查，再封装 USDZ；重新导入并比较轮廓、明暗、贴图连接和尺度。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 轻量 USDZ 贴图不超过 2048 px 本阶段遵循的原则是：交换材质使用受支持的 Principled BSDF 路径。 在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 诊断从最早拥有变量的阶段开始。“轻量 USDZ 贴图不超过 2048 px”提供最小可证伪测试；测试失败就向上游收缩，测试通过再逐项恢复材质、灯光、修改器、路径与导出设置。
阶段门槛。 通过条件是 所有实际面都有材质。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：把 OpenGL 改为 DirectX 不能替代修复网格法线。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
阶段 8 — 最终验证
执行动作。 从最终交付包验证“从 Blender 正确导出 USDZ 与 USDC 材质和法线”并归档证据。 本阶段只有一个责任人和一个输出。先在最小样本操作，并在改变拓扑、路径、色彩、层级或导出状态前保存检查点。
控制变量。 USDC 重导与 USDZ/Quick Look 是独立门槛 本阶段遵循的原则是：自动移除未分配给任何面的材质槽，不应直接报错。 在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，这不是笼统建议，而是可测量的制作规则。把相关尺寸、路径、数据块名称、材质通道、对象数量或目标查看器结果写入记录，让第二位制作者不依赖记忆也能复现决定。
理解原理。 最终门槛验证交付物而不是作者环境。“USDC 重导与 USDZ/Quick Look 是独立门槛”必须从最终根目录、重新导入文件或目标查看器取得证据。源路径、缓存和临时副本应暂时不可用，以暴露隐藏依赖。
阶段门槛。 通过条件是 未使用材质槽自动移除。依据结论保存测量值、大纲快照、路径清单、中性渲染、验证器报告、重新导入或目标查看器对比。已知陷阱是：文件成功写出不代表目标支持所有着色节点。 未通过时应回到最早拥有该故障的阶段，而不是在下游用补偿手段制造新隐患。
阶段检查
阶段 | 合格标准 | 必须留存 |
|---|
1 | 所有实际面都有材质 | 保存可复现证据 |
2 | 未使用材质槽自动移除 | 保存可复现证据 |
3 | 没有意外置换连接 | 保存可复现证据 |
4 | 法线约定正确 | 保存可复现证据 |
5 | 自定义法线有效或已清除 | 保存可复现证据 |
6 | 重新导入的尺度与方向一致 | 保存可复现证据 |
7 | 所有实际面都有材质 | 保存可复现证据 |
8 | 未使用材质槽自动移除 | 保存可复现证据 |
“从 Blender 正确导出 USDZ 与 USDC 材质和法线”的评审者应能在不询问作者的情况下找到每项证据，并判断它对应哪个版本、源文件与目标。截图要保留诊断上下文，数字必须带单位，导出证据必须来自最终包而不是临时目录。
原理解释
“从 Blender 正确导出 USDZ 与 USDC 材质和法线”遵循“最早责任阶段”：尺度错误不能靠相机透视修正，原点错误不能每次手动偏移，色彩空间错误不能靠灯光补偿，不支持的节点也不能寄希望于查看器猜测。越早把现象还原成单一变量，修复范围和回归面越小。
在“从 Blender 正确导出 USDZ 与 USDC 材质和法线”中，制作资产仍区分作者状态、交换状态和交付状态。作者状态保留可编辑性，交换状态缩小为目标能理解的表达，交付状态再针对体积、依赖和设备优化。三者使用独立副本与明确命名，避免为了便携永久破坏母版。
常见错误
错误 1： 因为存在未使用材质槽就拒绝导出，会制造不必要的手工清理。 先重现最小失败，再关闭无关灯光、节点分支、修改器、缓存或外部路径；每次只改一个条件，并保存同角度、同曝光、同目标对照。
错误 2： 交换时把高度连接到置换，可能导致模型严重变形。 先重现最小失败，再关闭无关灯光、节点分支、修改器、缓存或外部路径；每次只改一个条件，并保存同角度、同曝光、同目标对照。
错误 3： 把 OpenGL 改为 DirectX 不能替代修复网格法线。 先重现最小失败，再关闭无关灯光、节点分支、修改器、缓存或外部路径；每次只改一个条件，并保存同角度、同曝光、同目标对照。
错误 4： 文件成功写出不代表目标支持所有着色节点。 先重现最小失败，再关闭无关灯光、节点分支、修改器、缓存或外部路径；每次只改一个条件，并保存同角度、同曝光、同目标对照。
图 6：正确与错误对比。这是“从 Blender 正确导出 USDZ 与 USDC 材质和法线”流程中的无文字视觉检查点。诊断矩阵
症状 | 最可能原因 | 最小测试 | 纠正动作 |
|---|
因为存在未使用材质槽就拒绝导出，会制造不必要的手工清理。 | 交换材质使用受支持的 Principled BSDF 路径。 | 所有实际面都有材质 | 复制场景或建立专门导出视图层，避免改变最终渲染材质。 |
交换时把高度连接到置换，可能导致模型严重变形。 | 自动移除未分配给任何面的材质槽，不应直接报错。 | 未使用材质槽自动移除 | 移除没有分配给任何多边形的材质槽。 |
把 OpenGL 改为 DirectX 不能替代修复网格法线。 | 默认不要导出破坏性置换连接。 | 没有意外置换连接 | 建立交换安全的 Principled 网络，包括基础色、粗糙度、金属度、必要透明度和已验证法线。 |
文件成功写出不代表目标支持所有着色节点。 | 有目的地应用或保留变换。 | 法线约定正确 | 除非目标明确支持所需方式，否则断开置换。 |
技术图 2：从 Blender 正确导出 USDZ 与 USDC 材质和法线的症状、原因、测试和纠正矩阵。
图 7：诊断过程。这是“从 Blender 正确导出 USDZ 与 USDC 材质和法线”流程中的无文字视觉检查点。“从 Blender 正确导出 USDZ 与 USDC 材质和法线”按输入、结构、变换、映射、着色、导出边界与目标端诊断。最小测试如果同时改变两个以上变量，就没有可证伪性，应继续缩小。修复后必须重跑关键路径，因为局部正确不能证明打包、重新导入或目标查看器仍正确。
最终验证
图 8：最终验证。这是“从 Blender 正确导出 USDZ 与 USDC 材质和法线”流程中的无文字视觉检查点。“从 Blender 正确导出 USDZ 与 USDC 材质和法线”的最终验证使用从交付目录取得的文件，并暂时隐藏源路径。记录文件大小、SHA-256、对象与材质数量、缺失依赖检查、重新导入和目标查看器结果。交互内容还要记录加载、控制台错误和稳定帧表现；资产库则执行拖入、保存、关闭与重开。
交付清单
参考资料
以下原始资料定义“从 Blender 正确导出 USDZ 与 USDC 材质和法线”的事实边界；Blender 操作指向 5.2 手册，格式保证指向对应规范，Easy 行为限定在仓库版本与烟雾证据内。
VertexModeler
3D 文件格式
