1. 项目概述：为什么你的游戏角色需要更聪明的“脚”？

在Unity里鼓捣过角色移动的开发者，估计都经历过这么几个阶段：最开始，可能就是给角色一个速度向量，让他直来直去；后来发现会穿墙，于是加上了碰撞体；再后来，想让角色自己走到某个点，就开始写射线检测、寻路算法，代码越写越复杂，角色却走得越来越“傻”——要么卡在墙角疯狂抽搐，要么在多个移动单位中撞成一团，场面一度十分尴尬。

这就是为什么我们需要一套成熟、高效的AI寻路系统。它解决的远不止是“从A点走到B点”这么简单，核心是让角色在复杂、动态的虚拟世界里，像拥有真实感知和决策能力一样进行移动。NavMesh（导航网格）正是Unity官方为这个难题提供的“工业级”解决方案。它不是一个简单的“寻路插件”，而是一整套从场景数据烘焙、全局路径规划到局部动态避障的完整工作流。

简单来说，NavMesh系统帮我们做了三件关键事：第一，它把复杂的三维场景地形，烘焙成一张AI能理解的、覆盖所有可行走区域的“二维地图”；第二，当角色需要移动时，系统能在这张地图上快速计算出最优或次优的路径（这就是寻路）；第三，当路径上出现其他移动的敌人、玩家或者突然出现的障碍物时，角色能动态地、平滑地绕开它们，而不是僵硬地沿着预定路线撞上去（这就是动态避障）。

从《魔兽世界》里穿梭于主城的人流，到《求生之路》中从四面八方涌来的感染者，其底层都离不开类似的导航技术。对于独立开发者和小团队而言，掌握NavMesh，就意味着能用最小的性能开销，为游戏注入最基础的“智能”灵魂，让玩家的体验从“机械交互”跃升到“生动世界”。接下来，我就结合自己趟过的坑，带你从零开始，构建一个真正智能的移动角色。

2. 核心原理拆解：NavMesh系统是如何工作的？

在动手之前，我们必须先理解NavMesh系统背后的工作原理。很多开发者调不通API就放弃，往往是因为只知其然，不知其所以然。Unity的导航系统可以清晰地分为三个层次：导航网格烘焙（Baking）、全局路径寻找（Pathfinding）和局部障碍躲避（Local Avoidance）。

2.1 导航网格（NavMesh）：世界的可通行“地图”

想象一下，你要给一个机器人快递员规划送餐路线，你肯定不会给他一张标注了树木、喷泉、长椅的公园照片，而是会给他一张只画了人行道和十字路口的平面图。NavMesh就是这个“平面图”。

烘焙（Baking）就是这个“画地图”的过程。Unity的导航系统会分析你场景中所有被标记为“静态”且“可行走”的物体（如地面、斜坡、台阶），通过从上方向下发射无数虚拟射线，探测这些表面的轮廓和高度，最终生成一个由无数凸多边形（通常是三角形）拼接而成的网状表面。这个网络只覆盖角色可以站立和行走的区域，墙壁、悬崖、过陡的斜坡都会被自动剔除。

注意：这里的“可行走”是一个相对概念，完全由你定义的“代理（Agent）”参数决定。一个身高2米、半径0.5米的巨人所需要的通行空间，和一个半径0.2米的小精灵截然不同。烘焙前必须正确定义代理尺寸。

这个网格数据（NavMesh Data）会作为一个资源文件保存下来。它的精妙之处在于，由于组成网格的是凸多边形，因此网格内任意两点之间必然是直线可达的，不存在障碍物。这为后续快速的路径搜索打下了坚实基础。

2.2 全局寻路（Pathfinding）：计算最优路线

当地图准备好后，寻路算法（通常是A*算法及其变种）就可以登场了。当你在代码中调用NavMeshAgent.SetDestination()时，会发生以下几步：

1. 位置映射：系统首先将角色的当前位置（A点）和目标位置（B点），分别映射到NavMesh上最近的多边形（或称“导航网格三角形”）上。如果点落在网格外（比如悬空或嵌墙），寻路会失败。
2. 图搜索：系统将NavMesh视为一个“图”（Graph），每个多边形是一个“节点”，多边形之间共享的边是“连接”。A*算法会从起点多边形开始，评估移动到每个相邻多边形的“代价”（通常考虑距离），逐步探索，直到找到包含目标点的多边形。这个过程会生成一个由多边形序列构成的“通道”（Corridor）。
3. 路径平滑：直接让角色沿着多边形序列的顶点走，路径会显得非常生硬，像机器人。因此，系统会进行“拐点提取”（Funnel Algorithm），在这个通道内找到一系列关键拐点（Portals），最终输出一条由连续拐点连接而成的平滑折线，这就是角色实际要跟随的路径。

2.3 局部避障（Local Avoidance）：应对动态混乱

全局路径解决的是静态环境下的“战略”问题，而局部避障解决的是动态环境下的“战术”问题。试想，你规划了一条穿过广场的路线，但广场上突然涌来一群NPC。如果每个NPC都死死盯着自己的全局路径，结果必然是撞成一团。

Unity默认集成了RVO（Reciprocal Velocity Obstacles，互逆速度障碍）算法来处理这个问题。它的核心思想是预测与协作：

• 预测：每个移动的代理（Agent）不仅考虑自己当前的速度和方向，还会预测周围其他代理在下一时刻可能的位置。
• 协作：基于预测，每个代理会主动计算出一个新的、临时的速度向量。这个新速度既要尽可能靠近原本前往下一个路径点的方向，又要避免与所有预测的“未来障碍”（其他代理）发生碰撞。
• 互逆：关键在于“互逆”——所有代理都遵循同样的规则进行计算和让步，而不是一个停住让另一个先走。这使得一群代理能够像现实中的人群一样，自然地分流、绕行，产生非常逼真的群体移动效果。

对于非代理的移动障碍物（比如被玩家推开的箱子），Unity则提供了NavMesh Obstacle组件。它有两种模式：Carve（雕刻）模式会实时在NavMesh上“挖洞”，永久改变导航地图，适用于长期静止的障碍；而避障模式则仅作为动态障碍参与RVO计算，不影响全局路径，适用于短暂停留或缓慢移动的物体。

理解这三层协作，你就能明白，一个智能角色的移动，是静态地图、长期规划和瞬时反应共同作用的结果。

3. 实战第一步：场景烘焙与代理配置

理论懂了，我们开始动手。第一步是为你的世界创建一张精确的导航地图。很多新手在这里踩坑，导致后面寻路各种诡异。

3.1 场景准备：告诉Unity哪里能走

首先，你需要整理你的场景。在Hierarchy中，选中所有构成“地面”、“道路”、“可行走平台”的物体（如Terrain地形、Plane、Cube等）。在Inspector窗口的右上角，找到Static下拉框，确保其被勾选为Navigation Static。这意味着这些物体将参与导航网格的烘焙计算。

对于复杂的装饰物，如桌子、石头，如果角色可以从下面穿过（比如桌腿之间），或者可以跳上去，你需要仔细处理。通常，我们会将这些物体的Mesh Collider勾选上“Convex”凸体选项，并确保其也被标记为Navigation Static，这样烘焙时才会正确识别其轮廓作为障碍边缘。如果角色完全不能通过，比如一堵厚墙，那么它只需要有Collider阻挡物理移动即可，不一定需要参与NavMesh烘焙（除非你需要它在导航网格上产生“空洞”）。

3.2 导航窗口（Navigation Window）参数详解

打开Window > AI > Navigation窗口。这里有四个标签页，我们重点关注Agents和Bake。

Agents 标签页：这里定义不同类型的“旅行者”。你可以创建多个配置，比如“人类”、“巨人”、“老鼠”。

• Radius（半径）：代理的物理半径。这决定了路径的“宽度”。两个半径之和小于通道宽度，才能并排通过。设置过大会导致在狭窄处寻路失败。
• Height（高度）：代理的身高。低于此高度的天花板或洞口，代理不会尝试穿过。
• Step Height（可跨越高度）：像楼梯或路边石这样的高度，低于此值代理可以直接走上去，而不是绕路。这是一个非常影响体验的参数，设置合理角色上下台阶会很自然。
• Max Slope（最大坡度）：代理可以行走的最大斜坡角度（度）。超过这个角度的斜坡会被视为悬崖而不可行走。

Bake 标签页：这里控制如何生成导航网格。

• Agent Radius/Height/Step Height/Max Slope：与Agents页对应，但这里设置的是本次烘焙所针对的代理类型。通常与你预设的默认代理类型一致。
• Voxel Size（体素大小）：这是烘焙精度最重要的参数！它决定了将场景空间分割成的三维网格的大小。值越小，烘焙越精确，生成的NavMesh越贴合复杂地形（如楼梯、斜坡），但烘焙时间更长，生成的网格数据量也更大。对于大多数场景，0.1到0.3是一个合理的范围。新手常犯的错是使用默认值1，导致网格过于粗糙，角色在复杂地形上抖动或卡住。
• Min Region Area（最小区域面积）：过滤掉面积小于此值的孤立导航网格“孤岛”。可以清理一些由于模型缝隙产生的无用碎块。
• Height Mesh（高度网格）：勾选后，会生成更精确的高度信息，对于有大量斜坡和台阶的场景，能显著提升移动精度和平滑度，但会进一步增加烘焙时间和数据量。如果你的场景是复杂山地或室内多层结构，强烈建议开启。

配置好后，点击右下角的Bake按钮。烘焙完成后，Scene视图会以蓝色显示生成的导航网格。仔细检查：地面是否覆盖完全？墙壁边缘是否清晰？不该通过的地方是否有蓝色网格（说明有漏洞）？

实操心得：烘焙是一个迭代过程。不要期待一次成功。烘焙后，在Scene视图用鼠标点击蓝色区域，观察是否能在预期的地方生成路径。经常遇到的问题是，两个物体之间缝隙太小，但代理半径设置又较大，导致导航网格在此断开，角色无法通过。这时需要调整物体位置、缩放代理半径或调整Voxel Size。

4. 核心组件与脚本：赋予角色智能

地图有了，现在来创造行走在上面的智能体。

4.1 NavMeshAgent 组件详解

为你需要自动寻路的角色（一个GameObject）添加NavMeshAgent组件。这是整个系统的核心驱动器。

• Steering（操控）：

  • Speed（速度）：最大移动速度。
  • Angular Speed（角速度）：转向速度（度/秒）。值太低，角色转弯会像坦克一样笨拙。
  • Acceleration（加速度）：加速能力。影响起步和变速的流畅度。
  • Stopping Distance（停止距离）：在距离目标多远处开始减速并最终停下。对于攻击敌人，可以设置一个较小的值（如0.5），让角色贴近目标；对于移动到某个位置，可以设为0。
  • Auto Braking（自动制动）：接近目标时是否自动减速。如果取消勾选，角色会以恒定速度冲到目标点再瞬间停下，显得不自然，但在某些RTS游戏中需要。

• Obstacle Avoidance（障碍躲避）：

  • Radius/Height/Quality：这里可以设置用于避障计算的代理尺寸和计算质量。注意：这里的半径和高度可以与移动的物理尺寸不同。有时为了获得更灵敏的避障，可以设置一个比物理碰撞体稍大的“感知半径”。
  • Priority（优先级）：避障优先级（0-99）。值越低，优先级越高。在人群中，你可以让重要的NPC（如国王）拥有高优先级（低数值），这样平民会自动为他让路。

• Path Finding（路径寻找）：

  • Auto Traverse OffMesh Link（自动通过OffMesh链接）：是否自动处理跳跃、攀爬等动作（下文详述）。
  • Auto Repath（自动重新寻路）：当路径中断（如中间障碍物变为不可通行）时，是否自动计算新路径。

4.2 基础移动控制脚本

有了组件，控制移动只需一行核心代码：

using UnityEngine; using UnityEngine.AI; // 必须引用AI命名空间 public class SimpleAgentController : MonoBehaviour { private NavMeshAgent agent; private Camera mainCamera; void Start() { agent = GetComponent<NavMeshAgent>(); mainCamera = Camera.main; } void Update() { // 示例：鼠标点击移动 if (Input.GetMouseButtonDown(0)) { Ray ray = mainCamera.ScreenPointToRay(Input.mousePosition); RaycastHit hit; if (Physics.Raycast(ray, out hit)) { // 关键代码：设置目标点 agent.SetDestination(hit.point); } } // 你可以在这里添加其他逻辑，比如到达目的地后做什么 if (!agent.pathPending && agent.remainingDistance <= agent.stoppingDistance) { if (!agent.hasPath || agent.velocity.sqrMagnitude == 0f) { // 角色已到达目的地 // Debug.Log("到达目的地！"); } } } }

这段代码实现了最基础的点击移动。agent.SetDestination()是发起寻路的指令，剩下的移动、转向、避障全部由NavMeshAgent组件在后台自动完成。

4.3 高级控制：速度、停止与重置

有时你需要更精细的控制：

• agent.isStopped = true：立即停止所有移动和路径跟随，但保留当前路径。适用于角色被攻击硬直。
• agent.ResetPath()：清除当前路径，角色会停在原地。与isStopped不同，它清空了目标。
• 手动控制速度：你可以通过agent.velocity直接赋予角色一个速度向量，NavMeshAgent会尝试将这个速度与避障计算结合。这在制作被击退、吹飞等效果时非常有用。
• agent.Warp(Vector3 newPosition)：将角色瞬间传送到新位置，并自动更新内部导航状态。慎用，常用于角色重生或过场动画，滥用会破坏导航连续性。

5. 动态障碍与局部避障实战

现在，让我们让人物真正“活”起来，能够应对动态环境。

5.1 使用 NavMeshObstacle 组件

对于场景中可能移动的障碍物，比如玩家可以推动的箱子、开关的门，或者临时出现的路障，你需要为其添加NavMeshObstacle组件，而不是仅仅依靠碰撞体。

• Shape（形状）：可以选择立方体（Box）或胶囊体（Capsule）来匹配障碍物外形。
• Carve（雕刻）：这是核心功能。
  • 勾选Carve：障碍物会在NavMesh上“挖”出一个洞，永久性地改变导航地图。这适用于静止或很少移动的障碍。当它移动时，旧的洞会被填充，在新位置重新挖洞。性能开销较大，尤其是对移动的障碍物。
  • 不勾选Carve：障碍物仅作为一个动态避障参与者。它不会改变全局导航网格，但其他带有NavMeshAgent的个体会通过RVO算法避开它。这适用于持续移动的物体（如巡逻的敌人、其他玩家）。

配置策略：

• 一扇门：平时关闭时，使用带有Carve的NavMeshObstacle，阻挡通路。当门打开时，禁用这个Obstacle组件（或取消Carve），导航网格就会连通。
• 一个被玩家踢来踢去的球：使用不Carve的NavMeshObstacle，并确保其有刚体（Rigidbody）和碰撞体。其他AI会实时避开它，但不会影响全局寻路。

5.2 处理移动中的障碍物

当障碍物移动时，NavMeshObstacle 的velocity属性至关重要。如果你为障碍物添加了刚体，NavMeshObstacle 会自动从刚体获取速度。如果没有，你需要手动在脚本中设置obstacle.velocity。提供准确的速度信息，能让RVO算法做出更精确的预测，避障行为会更加自然。

// 在一个移动障碍物的脚本中 public class MovingObstacle : MonoBehaviour { private NavMeshObstacle obstacle; private Vector3 lastPosition; void Start() { obstacle = GetComponent<NavMeshObstacle>(); lastPosition = transform.position; } void Update() { // 计算当前帧的速度（单位/秒） Vector3 currentVelocity = (transform.position - lastPosition) / Time.deltaTime; obstacle.velocity = currentVelocity; lastPosition = transform.position; } }

5.3 群体移动与避障参数调优

当你有一大群单位同时移动时（比如RTS游戏中的士兵海），避障效果直接决定了体验。

• 调整NavMeshAgent.obstacleAvoidanceType：这个属性有四个等级，从None（无避障）到High Quality（高质量避障）。高质量意味着更远的预测距离和更复杂的计算。对于大量单位，使用Good Quality或Medium Quality能在效果和性能间取得较好平衡。
• 分层管理：不要所有单位都用同样的避障优先级。为不同类型的单位（步兵、骑兵、英雄）设置不同的priority。通常，重要的、体积大的单位优先级更高（值更小）。
• 性能监控：在Profiler中观察Navigation.Avoidance和Navigation.Obstacle的开销。如果群体数量极大（上百），可能需要考虑简化代理的碰撞形状、降低避障更新频率，或者使用更简化的群体移动算法（如流场算法Flow Field）作为补充。

6. 高级应用：OffMeshLink 与自定义区域

基础寻路和避障满足大部分需求，但一些高级玩法能让你的世界更加丰富。

6.1 跨越鸿沟：使用 OffMeshLink

NavMesh是连续的表面，但游戏里常有需要“跳跃”过沟渠、“攀爬”上高台、“走楼梯”或“通过传送门”的需求。这时就需要OffMeshLink。

它连接两个不在同一导航网格片段上的点。创建方法：

1. 在场景中创建两个空GameObject（如StartPos和EndPos），放在跳跃的起点和终点（确保两点都在导航网格上或非常接近）。
2. 选中其中一个点，在Inspector中点击Add Component > Navigation > Off Mesh Link。
3. 将StartPos拖入Link组件的Start字段，EndPos拖入End字段。

关键参数：

• Cost Override（代价覆盖）：可以设置通过此链接的“代价”高于普通行走，这样AI在寻路时，如果有一条更远的纯步行路径，可能就不会选择跳跃。
• Bi Directional（双向）：链接是否可双向通过。
• Activated（激活）：可以动态控制链接的开关。
• Auto Update Positions（自动更新位置）：如果起点和终点对象会移动，勾选此项。

如何通过：当NavMeshAgent的路径包含一个OffMeshLink时，它会自动接近起点，然后触发链接。你需要通过检查agent.isOnOffMeshLink属性来得知这一状态，并手动处理“通过”的过程，例如播放跳跃动画、施加一个速度等。处理完成后，调用agent.CompleteOffMeshLink()来告诉系统链接已通过，角色将移动到终点。

void Update() { if (agent.isOnOffMeshLink) { // 1. 可以在这里播放跳跃/攀爬动画 // 2. 使用Vector3.Lerp或其它方式将角色从起点移动到终点 // 3. 移动完成后 agent.CompleteOffMeshLink(); } }

6.2 定义不同地形成本：导航区域（NavMesh Area）

不是所有路都一样好走。草地、沼泽、公路、敌人的警戒区，移动的代价和速度应该不同。Unity通过NavMesh Areas来实现。

1. 在Navigation窗口 > Areas标签页，你可以定义多个区域（如“Walkable”, “Mud”, “Road”），并为每个区域分配一个Cost（代价）。代价越高，寻路算法越不愿意选择这条路。
2. 在场景中，选中特定的地面物体（如一个沼泽地的平面），在Inspector的Static下拉框旁，找到Navigation Area，将其从默认的“Walkable”改为你定义的“Mud”。
3. 重新烘焙场景。该物体生成的导航网格部分就会被标记为“Mud”区域。
4. 在NavMeshAgent组件上，有一个Area Mask字段。它是一个位掩码，用于指定此代理可以行走在哪些区域上。如果你的代理不能进入沼泽，就取消勾选“Mud”。

这样，当你命令一个代理穿越混合地形时，它会自动计算出一条总代价最低的路径，可能宁愿绕远走公路，也不愿直接穿过沼泽。

7. 常见问题、性能优化与调试技巧

即使理解了所有概念，实际开发中依然会遇到各种妖魔鬼怪。这里记录一些典型问题和解决思路。

7.1 寻路失败与路径异常

• 问题：agent.SetDestination()返回false，或角色在原地发呆。
  • 排查：首先检查目标点是否在导航网格上。使用NavMesh.SamplePosition函数来检测和修正目标点。

  Vector3 targetPosition; if (NavMesh.SamplePosition(hit.point, out NavMeshHit navHit, 1.0f, NavMesh.AllAreas)) { agent.SetDestination(navHit.position); // 使用修正后的位置 }

  • 检查：代理的Area Mask是否包含了目标点所在的区域？代理的尺寸（半径、高度）是否允许它通过通往目标点的路径？用Scene视图的导航调试工具可视化路径。
• 问题：角色在拐角处“抖动”或卡住。
  • 排查：通常是导航网格在该处生成不精确或有微小缝隙。尝试：1) 减小烘焙的Voxel Size；2) 检查拐角处的模型，确保它们紧密结合，没有肉眼不可见的缝隙；3) 适当增大代理的Radius，有时过小的半径反而会陷入网格瑕疵。
• 问题：角色不走“最短”路径，总是绕远。
  • 排查：检查是否有区域（Area）的Cost设置过高，导致算法认为直线路径“代价”更大。检查OffMeshLink的Cost是否合理。

7.2 性能优化要点

导航计算是CPU密集型任务，尤其是寻路和避障。

• 控制寻路频率：不要每帧都为大量单位寻路。对于巡逻的AI，可以每2-3秒更新一次路径。对于追击玩家的AI，可以在玩家移动一定距离后再更新路径。
• 分层烘焙与加载：对于大型开放世界，不要烘焙一个巨大的NavMesh。可以将世界分割成多个区域（如场景分块），动态加载和卸载对应区域的NavMesh数据。
• 简化代理：在远处或非关键区域的NPC，可以使用更简单的AI（如沿着固定路径移动），或者降低其避障质量。
• 使用NavMeshQuery进行异步寻路：对于非即时需求的寻路（如策略游戏预显示移动路径），可以使用NavMeshQuery进行异步计算，避免卡顿主线程。

7.3 强大的调试工具

Unity提供了极佳的导航调试可视化工具，在Scene视图的右上角Gizmos下拉菜单中：

• Show NavMesh：显示蓝色的导航网格。
• Show NavMesh Links：显示OffMeshLink。
• Show Agent Path：选中一个带有NavMeshAgent的对象，可以实时显示其当前计算出的路径（白色线）和下一个拐点。
• Show Obstacles：显示NavMeshObstacle的影响范围。

善用这些工具，可以直观地看到问题所在，比如路径为什么中断、障碍物是否生效等。

最后，记住NavMesh系统是一个强大的工具箱，但并非万能。对于超大规模单位的群体移动（如成千上万的昆虫群），可能需要结合流场（Flow Field）算法。对于需要复杂攀爬、飞行等三维寻路的场景，可能需要使用Waypoint（路点）系统或行为树（Behavior Tree）来辅助。但对于绝大多数地面移动的AI需求，从NavMesh烘焙到动态避障的这套流程，无疑是Unity开发者手中最可靠、最高效的解决方案。掌握它，你的游戏世界就将告别呆板的木偶，迎来真正拥有“生命”的居民。