1. 项目概述：当光照贴图“闹脾气”时

在Unity项目开发的中后期，尤其是美术资源大量导入、场景复杂度飙升的阶段，很多开发者都会遇到一个令人头疼的问题：明明烘焙前预览还好好的，一烘焙完，场景的光影就变得诡异起来。墙面出现奇怪的明暗条纹，角落里有不该存在的黑斑，或者整个物体的阴影完全错位，像是从另一个世界投影过来的。这就是典型的“光照贴图异常”。这个问题不解决，项目的美术品质会大打折扣，甚至可能因为错误的光照信息导致性能问题。今天这篇笔记，就是把我这些年跟Unity光照贴图“斗智斗勇”过程中积累的排查思路和修复方法，系统地梳理一遍。无论你是正在被某个角落的诡异黑斑困扰的TA，还是负责项目最终集成的客户端工程师，这套从原理到实操的“排雷”指南，应该都能帮到你。

光照贴图（Lightmap）的本质，是Unity为了提升运行时渲染性能，将复杂的光照计算（包括直接光、间接光、阴影）预先烘焙到一张或多张纹理上的技术。当它出现异常时，往往不是单一原因造成的，而是模型、UV、光照设置、烘焙参数等多个环节中某一环或多环出了差错。我们的修复工作，就是一个系统的“诊断”过程。

2. 核心问题诊断与排查流程

遇到光照贴图异常，切忌无头苍蝇一样乱调参数。一个高效的排查流程能帮你快速定位问题根源。我通常遵循“由表及里，由简到繁”的原则。

2.1 初步检查：排除低级错误与环境干扰

首先，我们需要确保不是一些基础设置或临时性问题导致的。

1. 确认烘焙状态与数据：在Unity编辑器的Window->Rendering->Lighting面板中，查看底部的状态栏。确保显示的是“Baked Global Illumination is enabled.”以及“Lighting data is not auto-generated.”或类似的已烘焙状态。如果显示需要烘焙或正在烘焙，请先完成一次完整的烘焙。
2. 检查光照贴图是否被正确应用：在Scene视图中，点击右上角的Shading Mode下拉菜单，选择Shaded Wireframe或Shaded，然后勾选下方的Lightmaps。此时，场景中应用了光照贴图的物体会显示出绿色的UV线框。如果某个物体没有显示绿色线框，说明它可能没有生成或应用光照贴图，这本身就是一种“异常”。
3. 清除并重新烘焙：Unity的烘焙系统有时会因缓存问题产生错误。一个最直接的方法是：在Lighting面板底部，点击Clear Baked Data按钮，然后点击Generate Lighting重新烘焙。这能解决大约30%的偶发性异常。
4. 检查光照模式：确保场景中用于烘焙的灯光（通常是Directional Light和Light Probe Groups使用的点光源/聚光灯）的Mode设置为Baked或Mixed。Realtime模式的灯光不会参与光照贴图烘焙，但其动态阴影可能与烘焙阴影冲突，造成视觉错误。

2.2 深度排查：聚焦模型与UV问题

如果初步检查无效，那么问题很可能出在模型资产本身，这是最常见的问题根源。

2.2.1 模型导入设置检查

选中问题模型，在Inspector面板中查看其Model分页下的导入设置。

• Scale Factor：不合理的缩放可能导致计算精度问题。通常保持1或与建模软件导出单位一致。
• Read/Write Enabled：这个选项非常关键！对于需要烘焙光照的静态物体，必须勾选。它允许Unity在烘焙时向模型的网格数据写入光照贴图UV等信息。如果未勾选，烘焙会失败或异常。
• Generate Lightmap UVs：这是自动为模型生成第二套UV（即光照贴图UV）的选项。对于没有在建模软件中手动展好光照UV的模型，必须勾选。但要注意，自动生成的UV质量可能不高，是许多问题的来源。

2.2.2 光照贴图UV诊断与修复

光照贴图异常，十有八九是UV问题。我们需要专门检查这套用于烘焙的UV。

1. 查看光照UV：在模型的Inspector面板中，切换到Mesh分页。在预览窗口下方，将UV Channel从0（主UV）切换到1（光照贴图UV）。观察这套UV：

   • 是否存在重叠（Overlapping）？重叠的UV意味着多个三维表面空间映射到了纹理的同一像素位置，烘焙时会导致光照信息相互覆盖、涂抹，产生难看的条纹或色块。这是导致黑斑、条纹的最主要原因。
   • 是否存在翻转（Flipped）？翻转的面片可能导致法线信息错误，从而接收错误的光照。
   • 是否拉伸严重（Excessive Stretching）？过度拉伸的UV会导致光照贴图分辨率利用率低下，细节模糊。
   • 是否超出[0,1]范围（Outside [0,1] bounds）？这通常意味着UV岛没有正确摆放，可能导致贴图重复或采样错误。

2. 修复UV问题：

   • 对于简单模型/自动生成UV：在导入设置中，调整Generate Lightmap UVs下的参数。
     • Hard Angle：默认88度。降低此值（如60度）会让UV分割更频繁，可能解决因硬边导致的UV扭曲，但会增加UV岛数量。
     • Pack Margin：默认0.0038。增大此值（如0.006）可以增加UV岛之间的间距，防止因烘焙时的纹理过滤（bleeding）导致的边缘颜色渗透。
     • Angle Error/Area Error：降低这些容差值，可以提高UV展开的精度，但会增加计算时间。
     • 操作建议：遇到自动UV导致的异常，可以尝试先勾选Generate Lightmap UVs，然后点击Apply。Unity会重新计算。如果问题依旧，尝试调整Pack Margin为0.005-0.01，并重新烘焙测试。
   • 对于复杂或重要的模型：最佳实践永远是在3D建模软件（如Maya, 3ds Max, Blender）中手动展开第二套UV。手动展UV可以完全控制UV岛的布局、比例和间距，彻底避免重叠、翻转和过度拉伸。导出时，确保这第二套UV作为模型的UV通道1（或2，需与Unity设置对应）导出。

注意：一个常见的误区是混淆主UV（通道0）和光照UV（通道1）。主UV用于漫反射贴图、法线贴图等材质纹理的映射；光照UV是专门为烘焙光照信息而准备的另一套坐标。两者独立，光照异常通常只与光照UV有关。

2.3 烘焙参数与场景设置调优

模型没问题，那就要看看烘焙的“火候”掌握得如何了。

1. 光照贴图分辨率与缩放：在Lighting面板的Lightmapping Settings中。

   • Lightmap Resolution：默认40（texels per unit）。这个值决定了每世界单位分配多少纹理像素。值太低，会导致光照细节模糊、出现块状感；值太高，会急剧增加烘焙时间和内存占用，甚至可能因精度过高放大UV边缘的瑕疵。对于出现模糊条纹的情况，可以尝试适当提高分辨率（如50或60）。
   • Lightmap Padding：默认2（texels）。这是UV岛之间的间隔。如果出现UV岛边缘颜色相互“渗色”的情况，可以适当增加这个值（如4或5）。
   • 对象单独缩放：在场景中选中物体，在Inspector面板的Mesh Renderer组件里，找到Lightmapping部分下的Scale In Lightmap。这个值可以单独调整该物体在光照贴图中占据的比例。对于重要的、出现细节问题的物体，可以适当调高（如1.5）；对于不重要的远处物体，可以调低（如0.5）以节省贴图空间。

2. 光照烘焙器选择与质量：

   • Lightmapper：Unity提供Progressive CPU（渐进CPU）、Progressive GPU（渐进GPU，需硬件支持）和Enlighten（旧版）。Progressive系列交互性强，易于预览；Enlighten在某些复杂间接光场景可能更稳定。如果切换烘焙器后问题消失，可能是某个烘焙器的特定Bug。
   • Direct Samples/Indirect Samples/Environment Samples：这些采样值直接影响烘焙质量。值太低会导致噪点、光斑。如果场景中有细腻的软阴影或复杂的色彩反弹（Color Bleeding）问题，可以尝试提高Indirect Samples（如256提高到512）。但这会显著增加烘焙时间。

3. 场景静态标记：确保需要烘焙的物体，其Inspector面板右上角的Static复选框被勾选。只有静态物体才会被纳入光照贴图烘焙计算。同时，检查Light组件和Reflection Probe等是否也正确标记为静态或具有合适的模式。

3. 典型异常案例与专项修复方案

掌握了通用排查流程，我们再针对几种最常见的具体异常现象，进行“定点清除”。

3.1 案例一：墙面或地面出现规则/不规则的深色条纹或黑斑

• 现象描述：在较大的连续平面上，出现纵向或横向的暗条纹，或者不规则的斑点状暗区。
• 根本原因：光照贴图UV重叠。当两个或多个不同的三角面共享了光照贴图上同一个（或非常接近）的纹理像素时，它们的光照信息就会互相覆盖。在平面上，自动生成的UV如果布局不当，很容易造成这种面片间的重叠。
• 修复步骤：
  1. 选中出现条纹的模型，按照2.2.2节的方法检查其光照UV（UV Channel 1）。
  2. 如果发现UV岛有明显的重叠区域，首要解决方案是返回建模软件，手动规范地展开第二套UV，确保所有UV岛清晰分离，并有足够的间距（padding）。
  3. 如果使用自动生成，尝试在导入设置中显著增加Pack Margin（例如从0.0038增加到0.01），并勾选Generate Lightmap UVs后重新应用。然后清除光照数据并重新烘焙。
  4. 检查模型的网格是否包含了不必要的、极其细长的三角面。有时建模遗留的废面或破碎的面会导致UV生成异常。可以在建模软件中清理网格或使用Unity的Mesh Cleanup相关工具（需第三方资产或手动检查）。

3.2 案例二：物体边缘有光晕或颜色“渗色”

• 现象描述：物体在光照贴图中的轮廓外围，有一圈不自然的浅色或深色边缘，像是颜色从物体本身“漏”到了背景上。
• 根本原因：纹理过滤（Texture Filtering）和UV间距不足。在实时渲染采样光照贴图时，GPU会在像素之间进行插值过滤（如双线性过滤）。如果UV岛之间的间隔（Padding）太小，过滤时就会采样到相邻UV岛的颜色信息，造成颜色渗透。
• 修复步骤：
  1. 全局性调整：在Lighting面板中，增加Lightmap Padding的值，例如从2调整到4或5。这是最直接有效的方法。
  2. 局部调整：如果只是个别物体有问题，可以选中该物体，在Mesh Renderer的Lightmapping下，虽然没有直接的padding设置，但可以通过提高Scale In Lightmap来间接增加该物体在光照图集上的实际占用面积，从而相对增加与其他物体的间距。
  3. 检查UV布局：手动展UV时，确保UV岛之间留出足够的空白区域。

3.3 案例三：阴影错位、断裂或消失

• 现象描述：物体投射的阴影与物体本身分离、中间断裂，或者该有阴影的地方完全没有。
• 根本原因：模型网格问题或光照UV严重失真。阴影烘焙依赖于模型的几何信息。如果模型有重复顶点、未焊接的顶点、或法线错误，可能导致阴影计算错误。此外，如果光照UV存在极端拉伸或扭曲，阴影信息被“画”在了错误的位置。
• 修复步骤：
  1. 检查网格完整性：在建模软件中，确保模型是“水密”的（无破面），顶点已焊接，法线方向统一（朝外）。可以使用“Recalculate Normals”或“Unify Normals”功能。
  2. 检查光照UV：确认光照UV没有严重失真。一个快速测试方法是：在材质上使用一张棋盘格纹理，并将其应用到光照UV通道。在场景中观察，棋盘格应该均匀分布，没有严重的变形。如果变形严重，必须重新展UV。
  3. 检查光源和接收器设置：确保产生阴影的灯光Shadow Type不是No Shadow，且其Bias参数设置合理。过大的Bias可能导致阴影脱离物体；过小可能导致阴影自遮挡（Peter Panning）。同时，接收阴影的物体必须勾选Static，并且其Mesh Renderer的Receive Shadows选项是开启的。

3.4 案例四：烘焙后场景整体过亮、过暗或发灰

• 现象描述：烘焙结果与实时预览或预期效果相差甚远，整体亮度失调。
• 根本原因：光照强度、间接光反弹、曝光或颜色空间设置不匹配。
• 修复步骤：
  1. 检查灯光强度（Intensity）和间接光乘数（Indirect Multiplier）：Directional Light的强度通常不需要很大（如0.5-1.5）。过高的强度会导致全场景过曝。同时，检查灯光的Indirect Multiplier，它控制该灯光贡献的间接光照的强度。如果场景过亮，可以尝试降低它。
  2. 检查环境光照（Environment Lighting）：在Lighting面板的Environment选项卡下，Source如果设置为Color或Gradient，其强度会影响整体环境光。Environment Reflections的强度也会影响场景亮度。可以尝试调低Intensity Multiplier。
  3. 检查后处理（Post-Processing）与颜色空间（Color Space）：如果使用了后处理Volume，检查其中的Tonemapping和Exposure设置是否正确。另外，确保Player Settings->Other Settings->Rendering->Color Space的一致性。烘焙是在Linear（线性）空间下计算的，如果你的项目设置是Gamma，或者烘焙后切换了颜色空间，会导致亮度显示错误。通常建议现代项目使用Linear颜色空间以获得更准确的光照计算。
  4. 使用光照探针（Light Probes）补充动态物体：静态场景的光照信息存储在光照贴图中，而动态物体则需要通过光照探针来获取环境光照。如果动态物体看起来发黑，可能是因为缺少光照探针或探针密度不足。在场景中合理布置Light Probe Group。

4. 高级技巧与性能优化权衡

解决了基本的异常问题后，我们还需要关注烘焙的效率和质量平衡。

4.1 光照贴图图集管理与纹理压缩

一次烘焙会为所有静态物体生成一张或多张大的纹理图集。管理好这个图集对内存和性能至关重要。

1. 查看光照贴图图集：烘焙完成后，在Lighting面板的Lightmaps选项卡下，可以看到生成的所有光照贴图。点击可以预览。
2. 纹理压缩格式：在Lightmapping Settings最下方，可以设置Lightmap Compression。默认是Low Quality，它使用一种特定的压缩格式。如果追求最高质量且内存充足，可以选择Uncompressed。注意：在移动平台，压缩是必须的，但需要测试压缩带来的色块问题。
3. 方向模式（Directional Mode）：这个选项用于生成“方向性光照贴图”，它额外存储了主要入射光的方向信息，用于配合法线贴图实现更真实的凹凸细节（例如Bumped材质）。启用它会使得每张光照贴图的大小翻倍（从RGB变成RGB+方向）。除非场景大量使用法线贴图且对凹凸光影要求极高，否则可以保持为Non-Directional以节省内存。

4.2 分块烘焙与渐进式更新

对于超大型场景，一次性烘焙所有内容可能不现实。

1. 利用光照探针代理体（LPPV）与遮挡探针（Occlusion Probes）：对于极其庞大的开放世界，可以将远处或次要区域的光照用光照探针来近似，只烘焙玩家活动频繁的核心区域。
2. 渐进式烘焙器（Progressive）的妙用：使用Progressive CPU/GPU烘焙器时，你可以随时暂停烘焙，观察当前结果。如果发现某个区域已经达到满意效果，而另一个区域还很噪点，你可以手动调整该区域物体的Scale In Lightmap或光源采样数，然后继续烘焙，实现资源的最优分配。
3. 场景分块烘焙：将大场景分割成多个子场景（Additive Loading），分别烘焙每个子场景的光照。这需要精心设计场景流式加载和光照数据的衔接，技术复杂度较高，但能有效管理烘焙负载。

4.3 烘焙流程的自动化与版本管理

在团队协作或需要频繁迭代的项目中，手动烘焙和排查是低效的。

1. 编写编辑器脚本：可以编写Unity Editor脚本，在资源导入后自动检查模型的Read/Write Enabled设置，或者批量设置一批预制体的Scale In Lightmap值。
2. 命令行烘焙：Unity支持通过命令行接口进行批处理式光照烘焙，这可以集成到持续集成（CI）流程中。命令类似于Unity.exe -batchmode -projectPath [项目路径] -executeMethod [你的烘焙方法] -quit。
3. 光照数据的版本管理：LightingData.asset文件存储了烘焙结果。这个文件应该被纳入版本控制系统（如Git）。但要注意，它的二进制格式可能导致合并冲突。良好的实践是，约定由特定的负责人或自动化流程在确定性的环境下执行烘焙并提交此文件，其他成员拉取更新，避免多人修改。

5. 疑难杂症排查清单与实战心得

最后，分享一个我常用的快速排查清单，以及一些从坑里爬出来的经验。

光照贴图异常快速排查清单：

实战心得：

1. 预防优于治疗：在项目初期就建立美术资源规范。强制要求所有静态场景模型必须在建模软件中导出包含规范的第二套光照UV（通道1）。这能从根本上杜绝80%的烘焙问题。
2. 迭代烘焙，小步快跑：不要等到整个场景做完才烘焙。每添加一批主要静态物体或调整主要光源后，就进行一次快速的、低分辨率的预览烘焙（使用Progressive烘焙器，跑几十个样本就暂停查看），及早发现问题。
3. 善用预览模式：在Lighting面板中，将Lightmapper设为Progressive，然后点击Generate Lighting。你可以在烘焙过程中实时观察场景光照的变化，一旦发现异常区域，可以立即暂停，针对该区域进行检查，效率远高于等全部烘完再看。
4. 文档记录：对于大型项目，记录下每个场景最终采用的Lightmap Resolution、Padding、关键物体的Scale In Lightmap值以及特殊的烘焙参数。这能保证不同成员或不同时间烘焙结果的一致性，也便于后续场景的参考。
5. 接受不完美：光照贴图烘焙是预计算，是真实光照的近似。在移动平台或性能受限的情况下，需要在视觉质量和内存/性能之间做出权衡。有时，轻微的颜色渗色或模糊，在游戏动态运行中是可以接受的。修复所有问题到完美所花费的时间成本，需要与项目整体进度进行权衡。