1. 项目概述：为什么我们需要CSG布尔插件？

在Unity里做模型，尤其是做关卡设计、建筑可视化或者一些需要快速原型验证的活儿，你肯定遇到过这种场景：脑子里有个很酷的造型，比如一个带圆孔的墙体，或者一个被切掉一角的平台。用传统的建模软件（比如Blender、Maya）做当然没问题，但流程就变成了：建模软件里做好 -> 导出FBX/OBJ -> 导入Unity -> 调整材质和碰撞体。一旦需要微调，这个循环就得再来一遍，非常打断创作的心流。

CSG（Constructive Solid Geometry，构造实体几何）就是为了解决这个痛点而生的。它的核心思想特别直观：用简单的几何体（立方体、球体、圆柱体）作为“积木”，通过布尔运算（并集、交集、差集）来组合或切割，从而生成复杂的形状。在Unity编辑器里直接实现CSG，意味着你可以像搭积木一样实时地构建和编辑场景中的几何体，所见即所得，迭代速度飞快。

虽然Unity自身没有内置官方的CSG工具，但社区和Asset Store里涌现了不少优秀的第三方插件，比如SabreCSG、ProBuilder（内置了部分布尔功能）、或者一些专门的布尔运算插件。这些工具将CSG的工作流深度集成到了Unity编辑器中。对于关卡美术、技术美术、原型设计师甚至是独立开发者来说，掌握一个趁手的CSG布尔插件，能极大提升从白盒到最终模型阶段的效率。它不仅仅是“挖个洞”那么简单，在制作自定义碰撞体、优化场景遮挡、创建程序化建筑部件等高级应用中，CSG思维能帮你打开新世界的大门。

2. 核心插件选型与基础环境搭建

市面上的Unity CSG插件各有侧重，选择哪一个取决于你的核心需求。

2.1 主流插件横向对比

提示：对于刚接触CSG的开发者，我强烈建议从ProBuilder开始。因为它免费、官方支持、文档齐全，并且其布尔功能足以应对80%的日常需求。等你熟悉了CSG的工作逻辑后，再根据特定需求去考察SabreCSG或专业插件。

2.2 以ProBuilder为例的环境搭建

这里我们以最通用的ProBuilder为例，演示如何搭建环境。Unity 2019.3及以上版本都支持通过Package Manager直接安装。

1. 打开Package Manager：在Unity顶部菜单栏，点击Window->Package Manager。
2. 切换显示模式：在Package Manager窗口左上角，将Packages:从Unity Registry切换到Packages: Unity Registry（如果已经是则不用改），确保你能看到所有官方包。
3. 搜索并安装：在搜索框输入“ProBuilder”。找到ProBuilder这个包，点击右下角的Install按钮。安装过程会自动引入相关依赖。
4. 启用功能：安装完成后，Unity顶部菜单栏会出现一个新的Tools菜单，下面有ProBuilder子菜单。为了使用布尔功能，我们需要进入Tools->ProBuilder->ProBuilder Window，打开ProBuilder的编辑窗口。更便捷的方式是，你可以在场景中选中一个普通GameObject，然后点击Tools->ProBuilder->ProBuilderize，将其转换为ProBuilder对象，或者直接使用Tools->ProBuilder->ProBuilder Toolbar打开一个浮动的工具栏。

2.3 基础概念建立：体积与网格

在开始布尔运算前，必须理解两个核心概念，这能避免很多后续的困惑：

• 实体体积（Solid）：这是CSG运算的基本单元。在SabreCSG中，你创建的就是“画笔”（Brush），它代表一个实心的体积。在ProBuilder中，一个ProBuilder网格物体在参与布尔运算时也被视为一个体积。布尔运算是在这些体积之间进行的，而不是仅仅在它们的表面。
• 网格完整性：布尔运算会生成新的网格。这个新网格的拓扑结构（顶点、边、面的连接关系）至关重要。一个“脏”的网格（包含重复顶点、开放边、非流形几何）会导致光照错误、碰撞失效、后续编辑困难。好的CSG插件会在运算后自动进行一定程度的网格清理，但你仍需具备判断网格健康度的眼力。

3. 基础操作：从零开始掌握布尔工作流

让我们用ProBuilder完成一次经典的“在墙上开一个窗户”的操作。这个过程涵盖了差集（Subtraction）这一最常用的布尔运算。

3.1 创建基础体积

1. 在Unity场景中，我们先创建一个作为“墙”的立方体。你可以用默认的GameObject -> 3D Object -> Cube，然后对其点击ProBuilderize。但我更推荐直接用ProBuilder工具创建：打开ProBuilder工具栏，点击Cube图标，在场景中拖拽创建一个立方体。将其Scale设置为 (5, 3, 0.2)，模拟一堵薄墙。
2. 接着，我们创建“窗户”的体积。同样用ProBuilder创建一个Cube，Scale设置为 (1.5, 2, 0.5)。将这个立方体移动到墙体的中间位置，并确保它在墙的厚度方向上完全穿透墙体。这是关键！布尔差集可以理解为“用B物体从A物体中挖掉B物体所占的空间”，所以B物体必须与A物体有充分的重叠体积。

3.2 执行布尔差集运算

1. 在场景中或层级视图中，首先选中作为“被挖对象”的墙体。
2. 然后，按住Ctrl（Mac上是Cmd）键，加选作为“切割工具”的窗户立方体。注意选择的顺序：先选A，后选B。
3. 在ProBuilder工具栏上，找到布尔运算的图标（通常是两个立方体交织的图形），点击旁边的小箭头，选择Subtract（差集）。
4. 点击后，ProBuilder会进行计算。完成后，你会发现墙体上被“挖”出了一个方洞，而那个作为工具的窗户立方体会自动被删除。这就是差集运算：A - B = 新A。

3.3 检查与优化结果

运算完成后，不要急着进行下一步。选中新的墙体网格，进入Vertex（顶点）或Face（面）编辑模式看看。

• 检查内部面：使用场景视图的线框模式（点击Scene视图右上角的Shaded->Wireframe）。你应该能看到墙洞内部的表面。有时插件生成的内部面（即窗户洞的内壁）可能没有正确的法线方向，导致在渲染时不可见。在ProBuilder中，你可以选中这些内部面，在检查器（Inspector）的ProBuilder组件里，点击Normals->Recalculate Normals来修正。
• 优化拓扑：布尔运算常会产生三角面数过多或分布不合理的网格。选中物体，在ProBuilder窗口的Tools面板下，可以使用Simplify（简化）或Subdivide（细分）工具来优化网格。对于将要用于最终渲染的模型，这一步尤其重要。
• 设置材质：为新生成的内部面单独赋予一个材质（比如内墙材质），使其与外墙区分开。

实操心得：布尔运算的“清洁度”极度依赖于原始几何体的简单性和对齐程度。尽量使用规则的、轴对齐的（Scale为1，旋转为0）基本体作为运算元。如果用一个复杂、旋转过的模型去进行布尔，极易产生破碎的网格和奇怪的三角面。记住：先定位，后运算。确保你的切割工具物体的位置、旋转、缩放都是精确的，必要时开启顶点吸附（V键）功能。

4. 高级应用：超越“挖洞”的创造性用法

掌握了基础差集，CSG的威力才刚开始显现。通过组合不同的运算和引入程序化思维，你可以解决很多复杂问题。

4.1 复杂造型的迭代构建

CSG不是一次性的操作，而是可以层层叠加的。例如，创建一个带有圆角凹槽的机械底座：

1. 创建基座：用一个扁平的立方体作为基础。
2. 挖出主凹槽：用一个细长的立方体执行差集，挖出凹槽形状。
3. 添加圆角：在凹槽的两端放置球体或胶囊体，执行并集（Union）。并集运算（A ∪ B）会将两个体积合并成一个连续的体积。这里我们用球体和底座做并集，相当于在凹槽两端“焊接”上两个半球，形成圆角。在ProBuilder中，操作顺序同样是先选底座（A），再加选球体（B），然后选择Union。
4. 钻孔：最后，用小的圆柱体在特定位置执行差集，添加螺丝孔。

这个过程就像雕塑，通过不断地添加和移除材料来达到最终形态。关键在于规划好操作的顺序，因为布尔运算通常是不可逆的（虽然ProBuilder支持一定程度的历史记录，但复杂操作后还是建议多保存副本）。

4.2 自定义碰撞体生成

Unity的Mesh Collider虽然能匹配复杂形状，但性能开销大。对于复杂的静态场景物体，一个最佳实践是：用高面数网格渲染，但用一个由简单几何体通过CSG生成的、低面数的复合碰撞体。

1. 复制一份你的复杂CSG模型（作为碰撞体专用）。
2. 使用ProBuilder或SabreCSG的网格简化工具，大幅降低其面数。目标是用最少的凸形状（Convex）或简单的凹形状来近似原模型。
3. 将这个简化后的网格，或者将其拆解成的多个基本几何体（立方体、球体等），添加Box Collider、Sphere Collider等基本碰撞体进行组合。
4. 更高级的做法是，直接使用这个简化后的CSG网格，为其添加一个Mesh Collider，并勾选Convex（如果是凸形状）或使用烹饪好的低精度网格。这比直接用高模做Mesh Collider高效得多。

4.3 程序化建筑部件生成

结合C#脚本，你可以将CSG操作程序化，用于批量生成建筑元素。例如，自动生成一系列不同宽度、高度，但带有统一风格窗洞的预制墙体。

1. 创建一个墙体预制体（Prefab），上面已经用CSG挖好了一个参数化的窗洞（窗洞位置、大小可调）。
2. 编写一个编辑器脚本，该脚本可以：
   • 读取一个平面布局图（甚至是一个简单的数组）。
   • 根据布局，实例化墙体预制体。
   • 通过脚本控制预制体上CSG“切割工具”的参数（如窗洞的Scale和LocalPosition），动态调整窗洞的大小和位置。
   • 在编辑模式下，调用ProBuilder的API（如BooleanOperation.Subtract）来执行布尔运算。
3. 这样，你只需要设计好基础的墙体单元和窗户样式，就能快速生成一整面规则或不规则的开窗墙体，极大地提升了制作大型建筑的效率。

4.4 场景优化与遮挡剔除辅助

在制作大型室内场景时，手动创建用于遮挡剔除（Occlusion Culling）的遮挡物（Occluder）很繁琐。CSG可以帮你快速搭建出贴合场景结构的、简化的遮挡体积。

1. 用大的立方体或自定义形状，通过布尔差集，快速“抠出”角色或相机能够通行的走廊、门洞空间。
2. 剩下的部分就是一个紧密贴合场景建筑的、封闭的“壳”。这个“壳”的网格通常很简洁。
3. 将这个“壳”设置为Occluder Static，并参与遮挡剔除的烘焙（Bake）。由于它形状贴合且简单，能产生非常准确的遮挡效果，提升运行时性能。

5. 性能优化与网格处理实战指南

CSG运算本质上是计算密集型操作，且生成的网格若处理不当，会成为性能杀手。以下是必须关注的优化点。

5.1 运算性能优化

• 简化运算元：在布尔运算前，尽可能简化参与运算的模型。能用10个面表示的就不要用100个面。在ProBuilder中，多使用Edge（边）编辑模式下的Connect Edges（连接边）或Fill Hole（补洞）来减少不必要的循环边。
• 避免实时运算：CSG布尔运算绝对不要在游戏运行时（Update函数中）每帧执行。它应该是一个编辑器工具或离线内容创建流程。运行时需要的复杂碰撞体，应预先在编辑器中制作好并保存为预制体。
• 分步运算：对于极其复杂的造型，不要试图用一个超级复杂的B物体去切割A。将其分解为多个简单的步骤，例如先挖方洞，再挖圆角，最后钻孔。这样每一步的计算量小，也更容易排查问题。
• 使用凸分解处理碰撞：如果生成的CSG模型必须用作动态物体的碰撞体，且形状复杂（凹形），不要直接使用非凸的MeshCollider。考虑使用第三方工具或Unity的VHACD算法（可通过一些插件或Asset Store资源获取）将凹形网格自动分解成多个凸形状的组合，性能会好很多。

5.2 生成网格的清理与修复

布尔运算后的网格常被称为“脏网格”。清理是必经步骤。

1. 移除重复顶点：这是最常见的问题。多个顶点在同一个位置但未合并，会导致UV撕裂、光照瑕疵。在ProBuilder中，选中物体，在ProBuilder窗口的Tools面板下，使用Cleanup->Weld Vertices（焊接顶点）功能，并设置一个很小的阈值（如0.001）。
2. 重建UV：布尔运算会破坏原有的UV映射。ProBuilder提供了强大的自动UV展开功能。在Face编辑模式下，选中所有需要重新展UV的面（通常是全部面），点击检查器中ProBuilder组件下的UV->Auto UV（自动UV）。你可以调整Auto UV设置中的Fill Mode（填充模式）和Padding（间隔）来获得更好的贴图效果。
3. 重算法线：确保所有面的法线方向一致向外。在ProBuilder中，选中物体或特定面，使用Normals->Recalculate Normals。对于硬边，你可能还需要手动设置平滑组（Smoothing Groups）或分割法线来达到理想的硬表面光影效果。
4. 三角面优化：检查网格的三角面分布。有时布尔运算会产生又长又细的“碎片化”三角面，这不利于后续的动画变形或细分曲面。可以使用Triangulate（三角化）或Quadrangulate（四边化）工具尝试重新拓扑，但需谨慎使用，可能会改变造型。

5.3 材质与贴图处理策略

CSG生成的新面是没有材质信息的。你需要手动或通过规则来分配。

• 规则化分配：写一个简单的编辑器脚本，在布尔运算后遍历新网格的所有面，根据其法线方向（例如，法线朝上的面是“顶面”，赋予屋顶材质）或世界坐标位置来自动分配材质ID。
• ProBuilder材质工具：ProBuilder允许你在Face模式下，选择特定的面，然后直接从Project窗口拖拽材质球到检查器的材质槽中，实现面级别的材质指定。这对于区分内表面、外表面、截面非常有效。

6. 常见问题排查与避坑实录

即使按照最佳实践操作，踩坑也在所难免。这里记录了几个我亲身经历的高频问题及其解决方案。

6.1 布尔运算失败或产生破碎网格

• 现象：点击布尔操作后无反应，或生成了支离破碎、包含大量零面积三角形的网格。
• 排查与解决：
  1. 检查重叠体积：确保两个物体有充分且正确的体积重叠。如果只是表面接触，没有体积穿透，差集运算可能失败。轻微移动一下“切割工具”物体，确保它完全穿过“被切割物体”。
  2. 检查模型完整性：参与运算的模型本身必须是“水密”（Watertight）的封闭网格，不能有洞或非流形边。在ProBuilder中，进入Edge模式，检查是否有边界边（通常呈亮蓝色）。如果有，需要用Fill Hole工具补上。
  3. 简化模型：将参与运算的模型所有不必要的细分线段移除。一个每边分段数都为10的立方体，其网格复杂度远高于分段数为1的立方体，也更容易出问题。
  4. 尝试交换顺序：有时A-B失败，可以尝试先隐藏A，复制一个B，然后用复制的B去和其他部分运算，或者尝试不同的操作顺序。
  5. 使用专业插件：如果ProBuilder的布尔始终失败，且模型确实复杂，考虑换用像Mesh Boolean这类更健壮的专业插件，它们通常采用了更稳定的布尔算法库。

6.2 运算后UV混乱或丢失

• 现象：布尔操作后，模型贴图严重拉伸、错乱或变成纯色。
• 排查与解决：
  1. 预期之内：这是正常现象。布尔运算创建了新几何体，旧UV信息无法保留。
  2. 解决方案：这就是为什么后处理必须包含重新展UV。不要尝试去修复旧的UV，直接使用ProBuilder的Auto UV功能为整个新模型或选中的面重新生成UV。对于规则形状（如墙面），Auto UV的Box投影模式通常效果很好。
  3. 手动调整：对于重要的表面（如主展示面），在自动展UV后，进入UV编辑模式，手动调整UV壳的位置和缩放，以更好地利用贴图空间。

6.3 生成的碰撞体不正常

• 现象：为CSG生成的模型添加MeshCollider后，物体掉落时穿模，或者角色卡住。
• 排查与解决：
  1. 非凸形警告：如果模型是凹形的，MeshCollider在不勾选Convex时才能正确工作，但性能差。Unity会给出警告。对于动态物体，这是一个必须解决的问题。
  2. 网格法线问题：碰撞体依赖于网格的法线方向来确定“内部”和“外部”。如果布尔运算导致部分面法线反转，碰撞系统可能会认为物体内部是外部。在添加碰撞体前，务必执行“重算法线”操作。
  3. 使用复合碰撞体：这是最可靠的方案。放弃使用单个MeshCollider。将你的CSG模型在思维上分解为多个凸形状（立方体、圆柱、棱柱），然后用多个Box Collider、Capsule Collider等基本碰撞体来近似拼凑出它的形状。虽然设置繁琐，但性能和可靠性都是最佳的。
  4. 清理网格：确保网格没有重复顶点、零面积三角形。这些缺陷会导致碰撞检测计算异常。

6.4 ProBuilder布尔操作后编辑器卡顿

• 现象：执行一次布尔运算后，Unity编辑器变得异常卡顿，操作不流畅。
• 排查与解决：
  1. 撤销历史：ProBuilder会记录详细的操作历史以便撤销。复杂的布尔运算可能会产生庞大的历史数据。尝试在ProBuilder窗口的Edit菜单中，选择Clear Undo（清除撤销历史）。
  2. 网格复杂度激增：检查布尔运算后的模型面数。有时一次差集操作会产生意想不到的巨大面数。使用Simplify工具降低面数。
  3. 关闭实时预览：一些插件或编辑器工具（如光照预览、反射探头更新）可能会在场景变化时进行重计算。在进行一系列CSG操作时，可以暂时关闭或降低这些实时效果的精度。

最后，我的个人体会是，CSG布尔插件是一个“思维放大器”。它强迫你用体积和空间的逻辑去思考建模，而不是单纯的顶点和面。初期你会觉得步骤繁琐，清理网格很麻烦，但一旦熟悉了这套从“体积布尔”到“网格清理”再到“UV/碰撞体处理”的标准流水线，你构建原型和解决特定几何问题的速度会有质的飞跃。它可能不是制作最终高精度艺术资产的工具，但在创意验证、关卡设计、技术方案解决阶段，绝对是工具箱里不可或缺的利器。开始的时候，不妨从一个简单的目标做起：不用任何外部建模软件，完全在Unity里用CSG做出一个带有门窗、楼梯和简单家具的房间白盒，你会对整个流程有深刻的理解。