企业官网建设流程全解析

做 3D 材质这几年，经常被问到同一个问题：为什么别人做一张金属贴图十分钟就能改出七八个变体，而自己还在 Photoshop 里一张张调曲线？答案基本都指向同一个工具——Substance 3D Designer。它把“画贴图”变成了“造贴图”，用节点图描述材质的生成逻辑，改一个参数就能衍生出一整套 PBR 贴图。本文围绕 Substance 3D Designer 的新版本展开，把环境准备、核心概念、完整实操、引擎对接、脚本批处理和排错思路串成一条完整链路，既适合刚接触程序化纹理的美术同学，也适合需要把材质流程接进引擎管线、批量替换材质的程序员和技术美术。读完你至少能做到：独立搭出一个可平铺的材料图、正确导出 PBR 通道、在 Unity 和 Unreal 里不出错地接上，并且知道出问题时该从哪里下手。

1. 程序化纹理与 Substance 3D Designer 的定位

1.1 从“画贴图”到“造贴图”的思路转变

传统贴图制作的起点是一张空白画布，终点是一张位图。中间的所有信息——这块地方为什么会反光、那道划痕是怎么产生的、边缘为什么变暗——全部被压扁在像素里，改一个细节往往要重画一片区域。程序化纹理的起点则是一个“规则”：高度从哪里来、噪声怎么叠加、遮罩怎么生成，最后才由软件按分辨率把规则烘焙成像素。这个转变最大的价值是可维护性：当你需要把一个原本 2048 分辨率的砖墙改成 4096，或者把砖缝从 2 厘米改成 3 厘米，程序化方案里只是改一个参数再点一次烘，传统方案里可能意味着重做。

从工程角度看，程序化纹理还有一层隐性的好处：它天然适合版本管理。节点图本质上是一份结构化的工程文件，节点之间的连线就是数据的流向，参数就是可调的输入。团队里两个人做同一种材质的不同变体时，可以共享同一个基础图再各自衍生，而不需要互相拷贝一堆命名混乱的 PSB 文件。这也是为什么在游戏、影视、建筑可视化这类需要大量材质资产的项目里，程序化方案几乎成了默认选择。

1.2 节点式工作流解决了什么问题

节点图的核心思想是“函数式”——每个节点是一个纯函数，输入若干张灰度图或颜色图，输出一张新的图。想加深颜色，就把颜色接到混合节点的 A 输入；想做斜向排列，就把噪声接到 Transform 2D 节点旋转 45 度。所有中间过程都是可见的、可以随时插一个 Blend 节点进去调权重的。这跟用 Photoshop 图层叠滤镜的体验类似，但区别在于：图层的效果是“已经作用上去”的，节点图的效果是“还没算出来”的，你随时可以回到任意一个分叉点重新定义它。

这种结构带来的第二个好处是复用。一个做得好的“铁锈遮罩”子图可以打包成一个单独的节点，拖进任何一个材质工程里用。团队可以把通用模块沉淀成自己的库，比如“混凝土裂纹生成器”“布料磨损遮罩”“木纹年轮生成器”，新人进来直接调用，不用从零摸索噪声参数。这一点在长期项目里能省下的时间相当可观，也是很多公司愿意投入人力建设内部材质库的原因。

1.3 适合哪些人学、需要什么前置基础

这门技术的主要使用者分三类。第一类是材质美术和纹理美术，把节点图当成主要创作工具，关注的是视觉效果和参数可控性。第二类是技术美术（TA），除了做材质本身，还要负责把材质图嵌进引擎管线、写自动化脚本、制定命名和导出规范。第三类是独立开发者和小团队，往往一个人兼任建模、贴图和效果调试，需要一套“改一个参数就能出新材质”的高效方案。

前置基础方面，不要求会写代码，但需要大致理解三件事：一是 PBR 的基本概念，知道 BaseColor、Roughness、Metallic、Normal、Ambient Occlusion 这几张贴图分别控制什么；二是灰度图的概念，明白 0 到 1 之间的数值如何映射成视觉上的明暗和粗糙程度；三是三维软件里的 UV 展开逻辑，因为可平铺（Tileable）材质的接缝问题和 UV 布局直接相关。如果你对 PBR 通道还不熟，建议先补一下引擎里的标准材质节点结构，再来学 Designer 会顺畅很多。

2. 环境准备与版本说明

2.1 硬件与系统要求

Substance 3D Designer 的计算量集中在两件事上：CPU 端的节点图求值和 GPU 端的实时预览。默认情况下，节点图是在 CPU 上多线程烘焙的，所以核心数越多、单核性能越强，Ctrl+E那一下的等待时间就越短。官方对显卡有最低要求，但实际体验上，显存决定了你能否在 4K 分辨率下流畅预览——如果只做 2K 以内的小图，中端显卡够用；一旦开始做 4K 甚至 8K 输出，显存不足会直接表现为预览卡顿或者预览不更新。

磁盘方面建议留足空间。一个中等复杂度的工程，.sbs文件本身可能只有几十 MB，但如果启用“缓存中间结果”或者频繁导出 4K 位图，工作目录很快就会涨到几个 GB。建议把工作目录单独放在一块 SSD 上，并在软件设置里把临时目录指向这块盘，避免系统盘被撑满之后出现导出中断。内存方面，16 GB 是舒适起步线，32 GB 以上在同时开引擎编辑器的情况下会更稳。

需要特别提醒的是：不同操作系统、不同显卡驱动版本下，预览渲染的表现可能有差异。如果升级系统或驱动之后发现预览花屏、贴图闪烁，第一件事是先回退驱动，而不是怀疑工程文件坏了。

2.2 版本号与授权说明

关于版本号，这里要说明一个容易混淆的点。Adobe 对 Substance 3D 系列采用的是按年份推进的版本命名方式，而不是简单的“第 N 版”。网络上流传的“V16”这类叫法，通常是某些发行渠道或第三方页面的自定义标注，与官方发布说明里的版本号并不一一对应。因此本文不逐条罗列所谓“某版本新增功能清单”，因为这类清单一旦和实际安装的版本对不上，反而会误导读者。

更稳妥的做法是：拿到安装包后，在软件的“帮助 → 关于”里确认实际版本号，然后对照官方的发布说明（Release Notes）查看该版本的具体变更。演示视频的正确用法也不是“看完就以为自己会了”，而是当成一个索引——看到某个让你眼前一亮的效果时，暂停，记下它大概用到了哪类节点，然后回到软件里自己复现一遍。本文后续章节的实操部分，刻意只使用长期稳定的核心节点，保证在多个版本上都能跑通；涉及版本可能有差异的地方，我会明确标注出来。

授权方面必须强调：Substance 3D 系列是商业软件，请通过官方渠道获取合法授权。教育用户、个人用户和团队用户有不同的订阅方案，具体以官方页面为准。使用非授权渠道获取的安装包，除了法律风险，还常常伴随组件缺失、脚本运行异常、导出中断等一堆难以排查的问题，对学习和工作都没有好处。

2.3 工程目录结构与文件类型

在动手之前，先把工程的组织方式定下来。Substance 3D Designer 的主工程文件后缀是.sbs，里面可以包含多个图（Graph）。对于单个材质，建议一个.sbs对应一个材质族，把不同变体做成同一个工程里的多个输出图，而不是拆成一堆独立文件。这样参数可以共享，后续做变体时不用重复搭建。

推荐的目录结构如下，目的是让“源工程”“导出结果”“脚本”三者分开，避免导出时把中间文件混进源目录：

ProjectName/ ├── src/ │ ├── materials/ │ │ ├── M_MetalBrushed.sbs # 主工程 │ │ └── M_MetalBrushed_Var.sbs # 变体（可选） │ └── libs/ │ └── L_CommonMasks.sbs # 团队通用子图库 ├── export/ │ ├── unity/ │ └── unreal/ ├── scripts/ │ ├── batch_export.py │ └── make_preview.sh └── docs/ └── material_spec.md # 命名与通道约定

这套结构看起来有点啰嗦，但在做过十几个材质之后你会发现，最耗时间的往往不是做材质，而是“找不到上次那张图导出到哪了”。提前把路径定死，后续接自动化脚本时会省很多事——脚本里写死的路径一旦和人工操作的路径不一致，排查成本非常高。

3. 核心概念拆解：读懂节点图

3.1 图（Graph）的类型与分工

打开软件新建工程，会看到几类不同的图。最常用的是Substance Graph，也就是我们日常说的“材质图”，它负责把各种节点连起来并最终输出贴图。另一类是Function Graph，用于定义可复用的函数逻辑，写完之后可以像普通节点一样在材质图里调用。还有一类是Generator，可以理解为“带参数的预设节点”，把一整套常用流程包装成一个可拖拽的模块。

新手最容易搞混的是“什么时候该用 Function Graph”。判断标准很简单：如果一段逻辑你打算在三个以上的地方重复使用，或者需要暴露几个参数让别人调，就抽成 Function Graph；如果只是一次性的连接，直接在主图里搭就行。过度抽象反而会让图变得难以调试——出问题时你得进到函数内部才能看到中间结果，效率会下降。

在同一个.sbs工程里可以放多个 Substance Graph。它们的节点是互相隔离的，但可以共享 Function Graph 和生成器资源。做材质变体时，建议复制一份图再改，而不是在原图上加一堆开关——除非你确实需要把变体打包成一个可切换的资产。

3.2 分辨率、平铺与位深

每个 Substance Graph 都有自己独立的输出分辨率设置，从 128 到 4096（部分版本支持更高）不等。这里有个非常关键的实践细节：节点图内部的计算分辨率和最终输出分辨率不是一回事。软件会在内部按需计算，某些节点可以在较低分辨率下运算来节省时间，但如果不注意，低分辨率的中途结果被放大之后会出现明显的块状或模糊。

真正稳妥的原则是：核心结构（比如砖块的排布、裂缝的走向）用较高的内部精度计算，噪声类细节可以适当降低。如果你发现导出的图在近距离观察时有格子感，先检查是不是某个关键节点的分辨率设置被调低了，而不是去怀疑导出设置。

关于平铺（Tileable），这是程序化纹理最重要的特性之一。一个“可平铺”的贴图，意味着它的左边缘和右边缘能无缝对接，上边缘和下边缘也能无缝对接，铺满任意大的平面时看不出接缝。Substance 里大量节点自带Tileable或Non-Uniform之类的参数，比如 Transform 2D 节点里的Tile选项，开启后偏移操作会保持平铺性。做可平铺材质时，务必让整条链路都保持平铺属性——只要有一个节点破坏了平铺性，最终结果就会有接缝。这也是新手最常见的踩坑点之一，后面第 8 章会专门讲排查方法。

位深方面，常规颜色图用 8 位即可，法线贴图和高度图建议用 16 位，因为 8 位的高度精度会导致法线出现明显的阶梯状。这个设置在输出节点（Output Node）的属性里可以调，也可以在导出预设里统一配置。位深选错的典型表现是：材质在引擎里看着“发花”，放大后能看到明显的色阶断裂。

3.3 色彩空间与 PBR 通道约定

这一节是很多人在引擎里翻车的地方。PBR 工作流里，不同的通道对色彩空间的要求是不同的：

核心规则只有一条：只有 BaseColor（以及 Emissive）需要 sRGB，其余全部是线性（Linear / Raw）。原因在于，颜色贴图是给人眼看的，需要经过 sRGB 编码来适配显示器的非线性响应；而粗糙度、金属度、法线这些是给着色器做数学运算的，必须保持原始数值不被 gamma 曲线扭曲。如果引擎把粗糙度贴图当成 sRGB 读进来，整个材质的反射表现会整体偏移，表现为“怎么调都不对劲”。

另外要注意通道打包（Channel Packing）。为了节省显存和贴图数量，很多项目会把 Roughness、Metallic、AO 三个灰度图打包进一张图的 R、G、B 通道里，引擎里再按通道采样。这种做法在主机和移动端很常见。通道打包的约定必须写进团队规范文档，明确哪个通道放哪个数据——不同项目之间的约定往往不一样，混用会导致材质完全错乱。

4. 完整实战：从零制作一个可平铺的拉丝金属材质

这一节我们把整个流程走一遍。选“拉丝金属”作为示例，是因为它既能覆盖高度、法线、粗糙度三条主要链路，又不需要太复杂的遮罩逻辑，适合作为第一个完整作品。下面所有节点名称都使用软件内置的标准节点，不依赖任何第三方插件。

4.1 新建工程与基础设置

启动软件后新建一个空工程，在工程面板里新建一个 Substance Graph，命名为M_MetalBrushed。进入图之后，第一步先设置输出分辨率。演示阶段用 2048，勾选平铺相关的全局选项（不同版本位置略有差异，一般在图的属性面板里）。然后建一个基础输出节点，把需要的通道先占位出来：BaseColor、Roughness、Metallic、Normal、Height。

这里有一个容易被忽略的设置：输出节点的Format和Bit Depth。建议在工程初期就固定下来，比如 BaseColor 用 8 位 sRGB，Normal 和 Height 用 16 位 Linear。如果一开始用了默认值，等做完图再改，某些节点的缓存可能需要重新计算，白白浪费时间。

4.2 构建高度与法线

拉丝金属的核心视觉特征是方向一致的细密划痕。先用一个Noise节点（各向同性噪声）作为基础，再用Transform 2D节点把它在水平方向拉伸，制造出方向感。具体做法是把 Transform 2D 的缩放设置为类似 X=1、Y=0.02 的比例，让噪声在纵向被极度压缩，形成细长的条纹。

接着用Blur HQ Grayscale轻微模糊一下，让条纹的过渡柔和一些，避免过于生硬。然后用Levels或Histogram Scan节点调整对比度，把条纹的疏密和深浅控制住。这一步的参数需要根据实际预览反复微调，没有固定值——关键是看着预览窗口，调到“近看有 Detail、远看不脏”的程度。

高度做好之后，接一个Normal节点把高度转成法线。这里要注意Normal节点的Intensity参数：它控制凹凸的强度，值调太大在引擎里会出现明显的硬边和假高光，通常从 1.0 开始试，调到视觉合适为止。另外要确认 Normal 节点的输出格式为 DirectX 还是 OpenGL——这两个约定在 Y 轴上是反的，选错了法线会“反向凸起”，在引擎里表现为光照方向完全不对。

4.3 构建粗糙度与金属度

金属材质的粗糙度决定了它是镜面还是哑光。拉丝金属的特点是：划痕处更粗糙（更哑光），平整处更光滑（更亮）。所以粗糙度的构建思路是“用高度图的对比度反向驱动”——把前面做的条纹高度取反，再映射到一个较窄的灰度区间，比如 0.2 到 0.45 之间。

具体节点链：把高度结果接一个Invert Grayscale取反，然后接Levels把输出范围压到目标区间。这里不要直接用Histogram Scan，因为它会强制拉满 0-1 的动态范围，导致粗糙度变化过猛。压区间这一步建议手动设置 In Low/High 和 Out Low/High，可控性更好。

金属度就简单得多：纯金属材质直接给一个Uniform Color节点，值设为 0.9 到 1.0 之间（完全 1.0 在部分引擎里会走特化的金属路径，视觉上反而偏暗，通常留一点余量）。如果要做的是“带锈的金属”，才需要用遮罩来控制金属度的分布，那就是另一个更复杂的图了。

BaseColor 方面，拉丝金属的颜色通常非常均匀，用一个Uniform Color给一个中性灰或略带色相的灰就够了。真正让金属“看起来像金属”的是粗糙度和反射，而不是颜色本身。新手常犯的错误是拼命在 BaseColor 上调色，结果怎么调都不像金属——问题往往出在粗糙度和金属度上。

4.4 输出节点与导出

所有通道接到输出节点之后，先在预览窗口里检查一遍：把预览切到球体或者布料模型，看看在不同光照角度下的表现。特别要检查接缝——把预览平铺模式打开，观察四个方向拼接的位置有没有亮度突变或条纹断裂。

确认无误后，点击导出。导出预设（Export Preset）里可以配置输出路径、文件名规则、位深和尺寸。建议给每个通道定义清晰的后缀，比如_BaseColor、_Roughness、_Normal。命名规范这件事在单人项目里显得多余，但一旦进入多人协作，统一的命名能直接决定导入引擎时能不能靠脚本自动识别贴图类型。

导出的文件名规则建议包含材质名和通道名两个维度，例如M_MetalBrushed_BaseColor.png。这样在引擎的内容浏览器里按名字排序时，同一个材质的所有通道会聚在一起，而不是散落在不同位置。

4.5 运行与验证

导出完成之后，先不要急着往引擎里拖。用一个简单的离线检查方式：把 Normal 图用图片查看器打开，正常的法线贴图整体应该呈现偏蓝紫色（因为 Z 分量占主导），如果整体偏红或者偏绿，说明通道顺序或者坐标约定出了问题。再把 Roughness 图打开，它应该是一张灰度图，不应该有明显的彩色。如果 Roughness 出现彩色，说明导出时色彩空间被误设成了 sRGB。

在引擎里验证时，建议搭一个标准检验场景：一个球体、一个平面、一盏主光加一盏补光，环境光用中性 HDRI。同一个材质在这个场景里的表现，才是你可以拿去对比和交付的效果。不同光照环境下看材质，很容易得出错误结论。

5. 自定义节点与表达式

5.1 Pixel Processor 与 Function Graph 的分工

内置节点能满足大部分需求，但遇到特殊逻辑时就需要写表达式。Substance 3D Designer 提供了两条路径：Pixel Processor是逐像素处理的节点，适合做那种“每个像素独立计算、根据输入值决定输出”的逻辑；Function Graph则是把一段可复用的处理流程封装成函数，内部可以调用各种内置函数。

选择标准是：如果逻辑只跟当前像素的几个输入值有关，用 Pixel Processor；如果逻辑涉及多次采样、多个节点串联，用 Function Graph 更清晰。两者的语法风格接近，都支持类似lerp、clamp、smoothstep这样的常用函数。

5.2 一个最小表达式示例

下面这段表达式可以放在 Pixel Processor 里，作用是把一个 0-1 的灰度输入映射成两端加强、中间压平的分布，常用来强化拉丝条纹的对比。这是核心片段，需要放进 Pixel Processor 节点的表达式编辑区，注意输入槽位的命名要和代码里的变量对应。

// 输入槽：$f0 为原始条纹灰度（0-1） // 输出：$out 为调整后的结果 $center = 0.5; // 中值基准 $strength = 0.65; // 对比强度，0 表示无变化 $delta = $f0 - $center; // 相对中值的偏移 $amplified = $center + $delta * (1.0 + $strength); $clamped = clamp($amplified, 0.0, 1.0); $out = $clamped;

这段代码做的事很直白：把每个像素相对 0.5 的偏移量按比例放大，再夹回合法区间。strength调到 0 就等同于原图，调到 1 以上会得到更强的对比但可能损失中间调细节。实际使用时建议先用 0.3 到 0.7 之间的值试，配合预览窗口实时观察。

需要提醒的是，不同版本对表达式内置函数的支持可能有差异，如果某个函数名报错，最稳妥的方式是查当前版本的节点文档，而不是照搬网上的代码片段。写完表达式后，务必用小分辨率先跑一次预览，确认没有语法错误再上高分辨率，否则一次烘焙可能要等很久。

6. 导出配置与引擎对接

6.1 Unreal Engine 的接入要点

在 Unreal 里使用这套贴图，关键是材质节点的连接方式。创建一个新的 Material，把 BaseColor 接到Base Color，Roughness 和 Metallic 分别接到对应引脚，Normal 需要先经过一个NormalFromTexture或者直接接Normal引脚（并确保采样类型设为 Normalmap）。最关键的一步是每张贴图的sRGB复选框：BaseColor 勾上，其余全部取消。这一步做错，材质会整体偏亮或偏暗，而且很难从视觉上立刻判断出来。

如果需要用到置换（Displacement）或者视差效果，Height 图也要一并导入，注意 Unreal 的置换需要在材质里显式设置Tessellation相关参数，并且对性能有影响，移动端项目通常不使用。对于大多数项目，法线贴图已经足够表达拉丝金属的细节。

6.2 Unity 的接入要点与自动化导入脚本

Unity 这边最容易出问题的是贴图导入设置。手动改的话，每张图都要设置 Texture Type、sRGB、Wrap Mode 等一堆选项，材质一多就容易漏。更好的做法是写一个AssetPostprocessor脚本，按文件名自动设置。下面这段脚本放在Assets/Editor/目录下，会按照文件名后缀自动判断贴图类型并套用正确的导入设置。

// 文件路径：Assets/Editor/SubstanceTextureImporter.cs using UnityEditor; using UnityEngine; public class SubstanceTextureImporter : AssetPostprocessor { // 所有属于 Substance 导出产物的目录名前缀 private const string RootFolder = "Assets/Textures/Substance/"; void OnPreprocessTexture() { // 只处理指定目录下的贴图，避免影响项目里其他资源 if (!assetPath.StartsWith(RootFolder)) { return; } TextureImporter importer = (TextureImporter)assetImporter; string fileName = System.IO.Path.GetFileNameWithoutExtension(assetPath); // 默认按线性处理，下面按后缀单独判断 importer.sRGBTexture = false; importer.alphaSource = TextureImporterAlphaSource.None; importer.mipmapEnabled = true; importer.wrapMode = TextureWrapMode.Repeat; if (fileName.EndsWith("_BaseColor")) { importer.textureType = TextureImporterType.Default; importer.sRGBTexture = true; } else if (fileName.EndsWith("_Normal")) { importer.textureType = TextureImporterType.NormalMap; importer.sRGBTexture = false; } else if (fileName.EndsWith("_Roughness") || fileName.EndsWith("_Metallic") || fileName.EndsWith("_AO") || fileName.EndsWith("_Height")) { importer.textureType = TextureImporterType.Default; importer.sRGBTexture = false; } Debug.Log($"[Substance] 已自动配置贴图导入设置: {fileName}"); } }

这段脚本的几个设计点值得说明。第一，用目录前缀做白名单，而不是用后缀做全局匹配，是为了防止项目里其他美术资源碰巧也叫xxx_Normal.png而被误改。第二，importer.sRGBTexture = false写在前面作为默认值，后面再针对 BaseColor 单独打开，这样即使新增了未知后缀的通道，也会走安全的线性路径。第三，wrapMode强制设为 Repeat，是因为程序化纹理基本都是可平铺的，用 Clamp 会在平铺时出现边缘拉伸。

需要注意的是，如果贴图已经导入过，修改脚本后需要右键选择Reimport才会生效。如果项目用的是 URP 或 HDRP，材质创建方式不同，但贴图导入设置这部分逻辑是通用的。

7. 用脚本与命令行做批量处理

7.1 Python API 的基本调用

当材质数量上来之后，逐个打开工程点导出会变成一件很枯燥的事。Substance 3D Designer 提供了 Python API，可以在软件内部执行脚本完成批量操作。下面这段脚本演示了遍历当前打开工程的所有 Substance Graph、打印它们的输出节点信息，这是写批量导出脚本的第一步。

# 文件路径：scripts/inspect_graphs.py # 用途：列出当前打开的工程中所有图及其输出节点 # 说明：接口可能随版本变化，运行前建议先在测试工程上验证 import sd def main(): ctx = sd.getContext() app = ctx.getSDApplication() pkg_mgr = app.getPackageMgr() # 获取当前加载的所有包 for pkg in pkg_mgr.getUserPackages(): print("Package:", pkg.getFilePath()) # 遍历包内的所有资源 for res in pkg.getChildrenResources(True): # 只关心 Substance 图资源 if "Graph" not in str(type(res)): continue print(" Graph:", res.getIdentifier()) # 遍历该图的所有输出节点 for node in res.getOutputNodes(): print(" Output:", node.getIdentifier()) if __name__ == "__main__": main()

这段脚本的作用是“探查”，而不是直接导出。先跑一遍确认能正确列出你的图和输出节点，再在此基础上加导出逻辑，是更稳妥的工程习惯。直接写一个几十行的批量导出脚本然后一把梭，出问题时你连是哪一步错的都不知道。

7.2 sbsrender 命令行批渲染

如果需要在没有图形界面的机器上做自动化（比如放进构建流水线），可以用配套的命令行工具做离线渲染。下面是一个调用示例，具体参数名请以你安装版本执行--help的输出为准，不同版本之间有调整。

#!/usr/bin/env bash # 文件路径：scripts/make_preview.sh # 用途：批量把 sbs 工程渲染成预览图 set -euo pipefail INPUT_DIR="./src/materials" OUTPUT_DIR="./export/preview" RESOLUTION="1024" mkdir -p "${OUTPUT_DIR}" for sbs_file in "${INPUT_DIR}"/*.sbs; do base_name="$(basename "${sbs_file}" .sbs)" echo ">>> 正在渲染: ${base_name}" # 具体子命令与参数请以本机 --help 输出为准 sbsrender render \ --inputs "${sbs_file}" \ --output-path "${OUTPUT_DIR}" \ --output-name "${base_name}_{outputNode}" \ --set-value "$outputsize" "${RESOLUTION}" echo "<<< 完成: ${base_name}" done echo "全部渲染完成，输出目录: ${OUTPUT_DIR}"

这段脚本用set -euo pipefail让错误立即中断，避免某个工程失败后脚本还继续跑出一堆不完整的结果。--output-name里用了{outputNode}这样的占位符，是让每个输出节点各自生成一张图。--set-value用来覆盖输出分辨率，这样同一份工程可以在预览时用低分辨率、交付时用高分辨率，不用改工程本身。

第一次使用时，建议先只放一个工程进去试跑，确认输出路径和文件名符合预期，再批量处理。同时注意，命令行渲染是纯 CPU 计算，工程复杂时耗时可能比预期长很多，最好放在空闲时段跑。

8. 常见问题与排查思路

8.1 材质出现接缝

这是最高频的问题。现象是：平铺之后在拼接位置出现一条明显的亮线或暗线，或者条纹方向突然错位。可能的原因有三个：某个节点破坏了平铺属性；使用了非平铺的噪声；Transform 2D 的偏移量没有被量化到平铺周期。

排查顺序建议这样走：先在预览里开启平铺模式确认接缝的具体位置（水平还是垂直，还是两者都有），然后从输出节点往前逐个接一个Preview节点，二分法定位是哪一段链路引入的问题。多数情况下问题出在Transform 2D的Tile参数没开，或者某个Blur节点在边缘做了不正确的边界处理。

8.2 导出后颜色和预览不一致

预览里看着正常，导出到引擎里整体偏亮或者偏灰。这种情况九成是色彩空间问题。先检查导出预设里每个输出通道的色彩空间设置，再看引擎端的贴图导入设置是不是又把 sRGB 打开了。两处都要对，只改一处没用。

还有一种可能是预览窗口的显示配置本身开了某些色彩管理，导致你看到的不是最终输出的真实值。判断方法是把导出的 PNG 直接用普通图片查看器打开，和预览对比；如果两者一致，问题一定在引擎端。

8.3 高分辨率下卡顿或烘焙超时

做 4K 输出时预览变得非常卡，或者点烘焙之后长时间没反应。先看任务管理器里的 CPU 和内存占用：CPU 跑满说明是纯计算瓶颈，只能等或者降分辨率；内存持续上涨接近上限，说明某个节点产生了巨大的中间缓存，需要回头精简链路。

一个有效的优化手段是“分段降低精度”：把噪声类节点的内部分辨率调低，只让结构类的节点保持高精度。另外，把 Blur 的半径控制在一个合理范围内也很关键，超大半径的高斯模糊在 4K 下代价极高，能用手动构造的渐变替代就尽量替代。

8.4 常见问题速查表

这张表建议贴在项目文档里，新人遇到问题时先自查一遍，能省下大量沟通成本。

9. 最佳实践与团队协作

命名规范是最基础也最容易被跳过的一环。建议采用M_前缀标识材质、T_前缀标识贴图，材质名用大驼峰，通道后缀统一。比如M_MetalBrushed对应的贴图是T_MetalBrushed_BaseColor。这套约定不一定要用我写的这个，但一定要在项目开始前统一下来并写进文档，否则做到一半再改名的成本会高得离谱。

参数暴露要克制。把节点图里所有可调参数都暴露出去，看起来灵活，实际上会让使用者面对几十个滑块无从下手。合理的做法是只暴露真正需要按场景调整的少数几个参数，比如“条纹密度”“粗糙度范围”“整体色相”，其余内部参数锁死。这本质上是在做 API 设计，原则和写代码一样：接口越小越稳定。

版本管理方面，.sbs是二进制或结构化工程文件，不适合直接做文本 diff。团队协作时建议用文件锁或者约定“谁在改这张图”的沟通机制，避免两人同时编辑同一个工程导致覆盖。更规范的做法是把材质工程和导出的贴图分开管理：工程进版本库，贴图作为构建产物按需生成，而不是把几百 MB 的 PNG 也提交进去。

性能意识要贯穿始终。在搭建节点图的过程中就时不时关注一下烘焙耗时，不要等到最后才发现整个图慢得无法迭代。一个实用的习惯是：每加完一组节点就按一次烘焙，感受一下时间变化，如果某一步之后时间突然翻倍，那就是需要优化的信号。

最后是安全和合规。涉及商业项目时，务必确认所有使用的材质、子图库、第三方资源的授权范围，避免把来源不明的资产混进交付内容里。团队内部共享的材质库也要有明确的来源记录，这对后期维护和法务审查都有好处。

10. 学习路线与下一步方向

如果你刚跟着本文做完第一个拉丝金属材质，接下来比较顺的路径是：先把“可平铺”这件事彻底吃透，尝试做砖墙、木地板、布料这三种典型材质，它们分别对应规则排列、有机纹理、纤维结构三类不同的问题。做完这三个，你对噪声、变换、混合这几类核心节点的直觉就基本建立了。

再往后可以往两个方向深入。一个方向是“复杂度”，学习如何用遮罩驱动多层材质混合，比如做旧金属、带苔藓的石材、磨损的塑料，这类材质的关键是分层思维和遮罩设计。另一个方向是“自动化”，把重复的导出、检查、命名工作用脚本固化下来，让材质从“手工制品”变成“可流水线生产的资产”。两个方向不冲突，实际工作中往往是交替推进的。

需要长期保持的习惯是：每做一个新材质，就把其中可复用的部分抽成子图，日积月累形成一个属于自己的模块库。程序化纹理的价值不在于单个材质的精美程度，而在于你积累的模块越多，下一个材质的起点就越高。这个复利效应在半年到一年的尺度上会非常明显。

演示视频可以看，但别只看。看到有意思的效果就暂停下来，猜一猜它大概是怎么搭的，然后自己动手复现一遍，复现不出来的地方才是真正需要补的知识点。这个过程比反复观看视频有效得多。