游戏 AI / 系统课时
路径出来却不移动怎么办
路径出来却不移动怎么办
看到 NavMesh 已经算出路径,却发现 NPC 原地不动时,不要马上怀疑寻路算法。路径查询成功、NavMeshAgent 进入可移动状态、角色 Transform 真正发生位移是三个不同阶段。本课用 Unity 的 NavMeshAgent 按这条链路逐层定位问题。
学习目标
- 区分路径计算成功、代理可移动和角色实际位移三个阶段
- 按固定顺序检查目标点、NavMeshAgent 状态与位置同步
- 用运行时诊断信息判断问题究竟发生在哪一层
先把“有路径”和“会移动”分开
SetDestination 成功只表示代理接受了目标请求,并不代表角色已经开始移动。路径计算可能仍处于 pathPending,最终也可能得到部分路径;即使路径完整,isStopped、speed、位置同步等状态仍可能阻止实际位移。
可以把整个过程拆成三层:目标点首先交给路径查询;NavMeshAgent 得到路径后,根据速度、停止状态和避障结果更新内部代理位置;最后由 updatePosition 等机制把代理位置同步到角色 Transform。

用诊断脚本确定卡在哪一层
下面的脚本会先确认代理确实位于 NavMesh 上,再提交目标点,等待路径计算结束后打印关键状态。将脚本挂到带有 NavMeshAgent 的 NPC,并给 target 指定场景中的目标 Transform。
using System.Collections;
using UnityEngine;
using UnityEngine.AI;
[RequireComponent(typeof(NavMeshAgent))]
public class NavMeshMoveDiagnostics : MonoBehaviour
{
public Transform target;
private NavMeshAgent agent;
private void Start()
{
agent = GetComponent<NavMeshAgent>();
StartCoroutine(CheckMovement());
}
private IEnumerator CheckMovement()
{
if (target == null)
{
Debug.LogError("Target is not assigned.");
yield break;
}
// 未放在有效 NavMesh 上时,不应继续提交路径请求。
if (!agent.isOnNavMesh)
{
Debug.LogError("Agent is not on a NavMesh.");
yield break;
}
bool accepted = agent.SetDestination(target.position);
Debug.Log($"SetDestination accepted={accepted}");
// 路径查询可能跨帧完成,等待 pathPending 结束后再判断结果。
while (agent.pathPending)
{
yield return null;
}
Debug.Log($"pathStatus={agent.pathStatus}");
Debug.Log($"isStopped={agent.isStopped}, speed={agent.speed:F2}");
Debug.Log($"updatePosition={agent.updatePosition}");
Debug.Log($"remainingDistance={agent.remainingDistance:F2}");
Debug.Log($"velocity={agent.velocity}");
}
}预期输出:当路径完整、代理未暂停且位置同步开启时,会看到类似结果;距离和速度向量取决于场景实际位置。
SetDestination accepted=True
pathStatus=PathComplete
isStopped=False, speed=3.50
updatePosition=True
remainingDistance=<DISTANCE>
velocity=<VELOCITY>如果 pathStatus 已经是 PathComplete,但后面的状态明显异常,就应该停止继续检查烘焙区域,转而检查移动驱动层。
按固定顺序定位最常见原因
先看 isOnNavMesh。代理如果没有正确落在 NavMesh 上,例如出生点偏离已烘焙区域,就无法作为正常导航代理工作。此时应修正出生位置,必要时使用 NavMesh.SamplePosition 在附近寻找合法落点,而不是不断重复提交目标。
接着看 pathStatus。PathPartial 表示只能到达目标方向上的某个位置,PathInvalid 表示没有有效路径。目标 Transform 在地图中存在,并不等于其位置一定处于当前代理可到达的 NavMesh 区域。
路径完整后检查 isStopped 和 speed。isStopped=true 会暂停沿当前路径移动;speed=0 则意味着代理即使拥有路径,也没有前进速度。游戏中的攻击、受击、动画或状态机经常会临时修改这些属性,因此还要检查是谁最后写入了它们。
最后检查 updatePosition。默认情况下它为 true,NavMeshAgent 会把模拟位置同步到 Transform。若项目为了 Root Motion 或自定义角色控制器主动设成 false,就必须自行使用 nextPosition 等信息完成同步,否则会出现内部代理在移动、画面中的角色却停在原地的现象。
验证修复是否真正生效
修复后不要只看 Scene 视图里的路径线。运行游戏并同时确认 pathStatus 为 PathComplete、isStopped 为 false、speed 大于零,并观察 velocity 在移动阶段不再长期保持零向量。
如果代理的速度已经非零,而角色 Transform 仍完全不变化,应优先检查 updatePosition、Root Motion、CharacterController 或项目自己的移动脚本是否覆盖了位置。反过来,如果 velocity 本身一直为零,则问题仍处于 NavMeshAgent 运动层,而不是模型或动画表现层。
排查这类问题最重要的是不要把“路径画出来了”当作移动系统已经正常。沿着路径结果、代理状态、最终位移三层逐级验证,通常能很快把问题缩小到真正负责这一层的代码。