1.1 动手前先对齐环境：Unity 版本与渲染管线要求

1.1 动手前先对齐环境：Unity 版本与渲染管线要求

本节摘要：Shader Graph 依附于渲染管线而存在，URP、HDRP、Built-in 三条管线决定了你能用哪些节点和主栈块。本节给出逐项检查清单，让你在建图之前确认版本、管线与包依赖全部对齐，避开"图建好了却渲染不出来"这类开工即翻车的问题。

一张图 ≠ 到处能跑

上一章立了"每章都产出能跑的东西"的目标，但"能跑"有个前提：你的项目里跑的是哪条渲染管线。很多教程不会告诉你的是，同一个 Shader Graph 资产放进不同管线的项目里，表现完全不同——Built-in 管线在 2021 之前的版本里根本打不开这个资产；URP 里能用的主栈块在 HDRP 里会多出一批高级光照输入；反过来，在 HDRP 里做的 Lit 图挪到 URP 项目，块会整体缺失并直接报错。

原因在于编译目标不同。Shader Graph 生成的不是一种通用代码，而是针对当前管线生成对应的着色器变体：URP 用轻量的 Universal 系列内置宏，HDRP 生成带体积雾、次表面散射等完整物理参数的复杂变体，Built-in 则是一套历史悠久的传统宏。图只是描述"要什么效果"，管线决定"用什么方式实现、开放哪些接口"。

图：三条渲染管线与 Shader Graph 的位置关系

逐项检查清单

建图前把下面四项按顺序过一遍，每一项都有明确的确认方法，不是凭感觉。

第一项：确认渲染管线。 打开项目设置里的图形设置面板，看"可编程渲染管线设置"（Scriptable Render Pipeline Settings）字段。字段为空说明当前是 Built-in 管线；指向一个渲染管线资产（Render Pipeline Asset）则看该资产的名字，带 Universal 字样的是 URP，带 HD 字样的是 HDRP。更快的办法是看场景窗口顶部：URP 项目下菜单里会有"渲染管线"相关的批量设置入口，HDRP 则有独自的天空与体积菜单。新建项目时直接选 URP 模板最省事。

第二项：确认 Shader Graph 版本。 打开包管理器，在"Unity Registry"里搜 Shader Graph。它没有独立版本号给你看，但依赖关系是固定的：SRP Core、Universal RP、Shader Graph 三者的版本必须一致——这是新手环境问题里比例最高的一种。如果包管理器里这三个包的版本号对不上，或者一个是预览版一个是正式版，材质就会显示成洋红色。处理办法很简单：把三个包统一升级到同一个推荐版本。

第三项：确认目标平台。 同样一张图，在编辑器里跑和在真机上跑可能表现不同。URP 下新建图时资产检查器里可以设置材质错误（Material Error）的处理方式；更常见的问题是移动端不支持某些纹理采样格式。做移动端项目时，把"构建目标"先切到 Android 或 iOS，再建图，能提前暴露格式问题。

第四项：确认渲染调试视图可用。 场景视图左上角的着色模式下拉里有"着色器诊断"相关项，如果你能正常切换到线框、过绘制等视图，说明管线数据通道健康。这个习惯在第 8 章性能分析时还会反复用到。

管线选择的工作经验

如果项目还没定型，怎么选？给一个直接的建议：除开画质要求明确是主机级大世界的团队，都从 URP 开始。理由有三条。第一，Shader Graph 的绝大多数教程、开源案例、商城资源都以 URP 为基准，遇到问题能搜到的解法多。第二，URP 的主栈块精简，图里每一根连线的用途都更容易看清，学习阶段干扰少。第三，URP 项目迁移到 HDRP 是单向且痛苦的操作，反过来很多 HDRP 专属节点在 URP 里本来就用不上，先学通核心节点族（第 3 章）在任何管线里都通用。

三个高频环境问题

问题：团队里每个人的效果观感不一致怎么办？

先查编辑器版本与管线资产是否完全一致，再查色彩空间设置（项目设置里的 Player 选项下，线性与伽马二选一）。这三个不一致里任何一个，都会让同一张图在不同机器上颜色有偏差。团队做法是把版本号写进协作文档：编辑器版本、URP 包版本、色彩空间三项，新人入项第一天先对齐这三项再开工。

问题：升级编辑器版本后旧图打不开或报错怎么办？

分两步。先看报错类型：如果是块缺失，说明新版本的管线包改了块结构，把图的备份恢复后逐块替换成新写法；如果是包冲突，回到包管理器把 SRP Core、管线包与 Shader Graph 三者升到同一版本。升级前先复制整个项目文件夹做备份，这个五分钟的动作能省掉一次回滚的整个下午。

问题：只想快速验证一个效果想法，还要走完整检查吗？

不用。日常验证用轻量流程：确认项目是 URP（看一眼包管理器即可）就直接建图。完整清单是给"新项目启动"与"环境出问题"两个时点用的——平时都健康，查清单是浪费；出问题时，清单就是排查手册。清单的意义不在每天都走一遍，而在出事时你知道该从哪查起。

一个团队协作的现实提醒

着色器资产的冲突处理比脚本麻烦：图文件是序列化资产，两个人同时改一张图，合并冲突几乎只能选一边。团队约定要么按效果分图（每人负责的图物理隔离），要么用"改前通知"的软约定——在分布式版本控制的时代，这仍是着色器资产协作最务实的两条路。

本节要点回顾

• 管线决定一切：Shader Graph 是按管线编译的，先确认 URP、HDRP 还是 Built-in，再动手建图。
• 三包版本一致：SRP Core、Universal RP、Shader Graph 版本错位是洋红色材质的头号来源。
• URP 优先：学习与多数项目场景下 URP 的资料量、节点精简度与性能平衡最合适。
• 平台先行：做移动端就把构建目标先切过去，贴图格式问题宜早暴露。

下一节我们就在这个对齐好的环境里，亲手创建第一个 Unlit 图，把"新建资产到材质上墙"这条操作链完整走一遍。