从零构建Unity NavMesh：烘焙、代理与动态寻路实战-平芜编程栈

1. 从零开始理解Unity NavMesh

如果你玩过RPG或者策略游戏，一定对NPC自动寻路的功能不陌生。想象一下，当你在游戏中点击某个位置，角色会自动绕过障碍物走到目的地——这就是导航寻路系统的魔力。Unity内置的NavMesh系统，正是实现这种功能的利器。

我第一次接触NavMesh是在开发一个塔防游戏时。当时手动编写寻路算法搞得焦头烂额，直到发现了这个"神器"。它就像给游戏世界铺了一层隐形的地毯，AI角色只能在这块地毯上行走。这块"地毯"是通过烘焙（Bake）生成的导航网格，本质上是一张记录了可行走区域的地图。

与A*等传统寻路算法不同，NavMesh最大的优势是性能。所有复杂的路径计算都在编辑阶段完成，运行时只需要简单的查询。实测下来，在移动设备上同时运行20个寻路Agent也能保持60帧。下面我们就从创建一个简单场景开始，一步步揭开它的神秘面纱。

2. 场景搭建与导航网格烘焙

2.1 搭建基础场景

打开Unity新建一个3D项目，我们先做个简易的迷宫：

创建平面（Plane）作为地面
添加几个立方体（Cube）作为障碍物
调整立方体位置形成通道

这里有个新手常踩的坑：尺寸问题。默认的1x1x1立方体在导航中显得太小，建议将地面缩放为10倍，立方体缩放为2x2x2。可以按这个比例布置你的迷宫：

// 建议场景尺寸参考 Ground: Position(0,0,0), Scale(10,1,10) Obstacles: Scale(2,2,2)

2.2 标记静态障碍物

选中所有障碍物和地面，在Inspector右上角找到Static下拉菜单。这里要特别注意：必须同时勾选Navigation Static和普通Static。我遇到过只勾Navigation Static导致烘焙失败的情况。

提示：可以全选所有物体后按Ctrl+Shift+N快速添加Navigation Static标记

2.3 导航网格烘焙参数详解

打开Window > AI > Navigation面板，重点看Bake页签的这些参数：

Agent Radius：相当于角色的"体型"，决定能通过多窄的通道
Agent Height：影响角色能通过的低矮空间
Max Slope：可攀爬的最大坡度（默认45度）
Step Height：可跨越的台阶高度

第一次使用时，建议先保持默认值点击Bake按钮。你会看到场景中出现蓝色半透明网格——这就是烘焙好的导航区域。如果发现某些应该通行的区域没有网格，可以适当减小Agent Radius。

3. 创建导航代理角色

3.1 添加NavMeshAgent组件

新建一个圆柱体（Cylinder）作为我们的AI角色。选中它后点击Add Component搜索NavMeshAgent。关键参数解析：

Speed: 5 // 移动速度（米/秒） Angular Speed: 120 // 转向速度（度/秒） Acceleration: 8 // 加速度 Stopping Distance: 0.5 // 在距离目标多远时停止

3.2 代理与障碍物的交互

在场景中尝试移动你的角色，会发现它能自动避开障碍物。这得益于NavMeshAgent的自动避障功能。你可以通过修改Avoidance Priority（0-99）来控制避让优先级，数值越高的代理越容易被其他代理避让。

实测发现一个小技巧：当多个代理相互阻挡时，适当降低Speed和Acceleration可以显著减少"卡顿"现象。比如设置Speed=3，Acceleration=5会让移动看起来更自然。

4. 实现动态目标寻路

4.1 基础寻路脚本

创建一个新C#脚本NavAgentController：

using UnityEngine; using UnityEngine.AI; public class NavAgentController : MonoBehaviour { [SerializeField] NavMeshAgent agent; [SerializeField] Transform target; void Update() { if(target != null) agent.SetDestination(target.position); } }

把脚本挂到代理角色上，然后将NavMeshAgent组件和目标Transform拖拽到对应字段。运行游戏，移动目标物体，角色就会自动追踪了。

4.2 高级寻路技巧

路径状态检测是实际项目中的必备技能。修改脚本增加以下功能：

void Update() { if(agent.pathPending) return; // 路径计算中 if(agent.remainingDistance <= agent.stoppingDistance) { if(!agent.hasPath || agent.velocity.sqrMagnitude == 0f) { // 到达目的地后的逻辑 Debug.Log("到达目标！"); } } }

这段代码解决了两个常见问题：

避免每帧重复计算路径
精确判断到达状态（考虑停止距离和惯性）

5. 动态障碍物处理

5.1 添加NavMeshObstacle

对于会移动的障碍物（比如推箱子的箱子），需要添加NavMeshObstacle组件。关键设置：

Shape：选择Box或Carve（根据物体形状）
Carve：勾选后会在移动时实时更新导航网格
Move Threshold：位移超过此值才重新计算

5.2 性能优化建议

动态障碍物虽然方便，但过度使用会导致性能下降。我的经验法则是：

静态物体永远用Navigation Static
偶尔移动的物体用NavMeshObstacle+Carve
频繁移动的物体改用物理碰撞+Agent避让

曾经在一个项目中，我把50个动态障碍物都开了Carve，结果帧率直接掉到20。后来改用分层处理，性能立刻回到60帧。

6. 常见问题排查

6.1 烘焙问题

问题：烘焙后没有蓝色网格显示解决：

确认所有障碍物都标记了Navigation Static
检查Navigation窗口的Display页签是否勾选Show NavMesh
尝试增大Bake面板的Agent Radius

6.2 寻路问题

问题：Agent卡在角落不动解决：

减小Agent的Radius和Height
检查目标点是否在导航网格上（用Debug.DrawLine可视化路径）
增加NavMeshAgent的Obstacle Avoidance Quality

6.3 动态障碍物问题

问题：角色穿过应该避开的障碍物解决：

确认NavMeshObstacle的Carve已启用
检查障碍物Layer是否被Agent的Avoidance Mask包含
适当减小Obstacle的Carve Only Stationary阈值

7. 实战案例：巡逻AI实现

结合上面知识，我们实现一个简单的巡逻系统：

public class PatrolAI : MonoBehaviour { public Transform[] waypoints; private int currentWaypoint = 0; private NavMeshAgent agent; void Start() { agent = GetComponent<NavMeshAgent>(); GoToNextPoint(); } void GoToNextPoint() { if(waypoints.Length == 0) return; agent.SetDestination(waypoints[currentWaypoint].position); currentWaypoint = (currentWaypoint + 1) % waypoints.Length; } void Update() { if(agent.remainingDistance < 0.5f && !agent.pathPending) { GoToNextPoint(); } } }

这个脚本可以让AI在预设的路径点间循环移动。在实际项目中，我通常会加上随机停留时间和路径点随机偏移，让移动看起来更自然。