1. 从零开始：理解NavMeshAgent与动态路径可视化

很多刚开始接触Unity游戏开发的朋友，尤其是做RTS、RPG或者需要角色自动寻路的项目时，都会遇到一个核心需求：怎么让角色自己走到目标点，并且还能把这条路线清晰地画出来给玩家看？ 我刚开始做项目那会儿，也在这个问题上卡了很久。Unity自带的NavMeshAgent组件确实强大，它能帮你处理复杂的寻路逻辑，但默认情况下，它只负责“走”，不负责“画”。角色闷头就走，玩家根本不知道它打算怎么绕开障碍物，体验上就差了点意思。

动态路径可视化，说白了，就是把NavMeshAgent计算出来的那条“看不见”的路线，实时地、动态地渲染在游戏场景里。想象一下，你在玩一个策略游戏，选中一个单位，点击地图上一个位置，一条发光的路径线立刻从单位脚下延伸到目标点，绕过所有的树木和岩石——这就是我们要实现的效果。这不仅仅是“酷炫”，它极大地提升了游戏的策略性和操作反馈感，让玩家对即将发生的行动一目了然。

要实现这个，核心就两个东西：NavMeshAgent 和 LineRenderer。NavMeshAgent是大脑，负责计算从A点到B点的最优路线；LineRenderer是画笔，负责把大脑计算出的路线坐标点连接起来，画成一条线。听起来很简单对吧？但实际做起来，你会遇到不少坑，比如路径线怎么实时更新、怎么让线看起来更美观（而不是一条死板的线段）、以及在性能上如何优化避免卡顿。别担心，接下来我会结合我踩过的那些坑，手把手带你实现一个既好看又高效的动态路径可视化系统。

2. 搭建寻路舞台：NavMesh烘焙与基础配置

在让角色动起来之前，我们得先为它搭建一个能“理解”的舞台。这就是NavMesh（导航网格）烘焙。你可以把NavMesh想象成铺在游戏场景地面上的一层隐形“可行走区域”网格，NavMeshAgent只会在这个网格范围内计算路径。如果某个地方没铺上这个网格，那对不起，角色是绝对不会走过去的。

2.1 场景准备与静态标记

第一步，不是写代码，而是在编辑器里摆好场景。把你希望角色能行走的地面（比如地形Terrain、一个大的Plane或复杂模型）以及所有障碍物（墙壁、箱子、岩石等）都准备好。

接下来是关键操作：将这些物体标记为Navigation Static。

  1. 在Hierarchy中选中你的地面和所有障碍物。
  2. 在Inspector窗口的右上角，找到“Static”下拉复选框，点击它。
  3. 在弹出的菜单中，勾选“Navigation Static”。这一步是告诉Unity的导航系统：“喂，这些物体在寻路时是静止不动的，请在计算时把它们考虑进去。”

注意：如果你的障碍物未来是会移动或破坏的（比如一扇可以打开的门，一个能被炸掉的墙），那么就不要把它标记为Navigation Static。对于动态障碍，我们有其他处理方法，后面会讲到。

2.2 导航面板烘焙与参数详解

标记好静态物体后，我们打开导航烘焙面板。菜单栏：Window > AI > Navigation。

你会看到四个标签页，我们主要关注 Bake（烘焙）页签。这里参数很多，但新手重点关注这几个：

  • Agent Radius（代理半径）： 这是你角色的“身体宽度”。想象角色是个圆柱体，这个值就是圆柱的半径。烘焙时，系统会保证路径离障碍物至少有这么宽的距离，防止角色“卡墙”。如果你的角色模型比较胖，这个值要调大点。
  • Agent Height（代理高度）： 角色的身高。系统会检查这个高度上方是否有障碍物（如矮洞），如果洞口高度小于此值，这里就不会生成可行走区域。
  • Max Slope（最大坡度）： 角色能爬上的最大斜坡角度。超过这个角度的斜坡会被视为不可行走的墙壁。
  • Step Height（台阶高度）： 角色能一步迈上去的最大台阶高度。这个对于有楼梯或小台阶的场景非常有用。

设置好参数后，直接点击右下角的 Bake 按钮。烘焙完成后，你的Scene视图（确保在Shaded模式下，并开启Navigation显示）中，可行走的地面会变成一片蓝色。障碍物区域则不会被蓝色覆盖。这就说明你的导航网格已经成功生成了！现在，你的游戏世界已经具备了基础的寻路能力。

3. 核心代码实战：让路径“画”出来

舞台搭好了，该演员上场了。我们创建一个角色（比如一个胶囊体Capsule），然后给它挂上核心组件：NavMeshAgent。挂上之后，你甚至不用写代码，在运行时修改其 destination 属性，它就能自己走过去。但我们的目标是画出路径，所以还得再加一个 LineRenderer 组件。

3.1 脚本编写：连接Agent与Renderer

我把完整的脚本先贴出来，然后咱们再逐块拆解，这样你更好理解。

using UnityEngine;
using UnityEngine.AI; // 关键命名空间

public class DynamicPathVisualizer : MonoBehaviour
{
    private NavMeshAgent _agent;
    private LineRenderer _lineRenderer;

    void Start()
    {
        // 获取组件
        _agent = GetComponent<NavMeshAgent>();
        _lineRenderer = GetComponent<LineRenderer>();

        // 初始化LineRenderer
        if (_lineRenderer != null)
        {
            _lineRenderer.startWidth = 0.2f;
            _lineRenderer.endWidth = 0.2f;
            _lineRenderer.material = new Material(Shader.Find("Sprites/Default"));
            _lineRenderer.startColor = Color.green;
            _lineRenderer.endColor = Color.cyan;
        }
    }

    void Update()
    {
        // 鼠标点击设置目标点
        if (Input.GetMouseButtonDown(0))
        {
            Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
            RaycastHit hit;

            if (Physics.Raycast(ray, out hit))
            {
                // 确保点击到的是导航网格（或者你指定的地面层）
                NavMeshHit navHit;
                // 更推荐使用NavMesh.SamplePosition进行精确的导航网格位置采样
                if (NavMesh.SamplePosition(hit.point, out navHit, 1.0f, NavMesh.AllAreas))
                {
                    _agent.SetDestination(navHit.position);
                }
            }
        }

        // 核心：实时更新路径线
        UpdatePathVisualization();
    }

    void UpdatePathVisualization()
    {
        if (_lineRenderer == null || _agent == null || !_agent.hasPath)
        {
            _lineRenderer.positionCount = 0; // 没有路径时清空线
            return;
        }

        // 获取当前路径的所有拐角点（Corners）
        Vector3[] corners = _agent.path.corners;

        // 设置LineRenderer的点数和位置
        _lineRenderer.positionCount = corners.Length;
        _lineRenderer.SetPositions(corners);
    }
}

代码拆解与避坑指南：

  1. 获取路径点：_agent.path.corners 是核心中的核心。NavMeshAgent.path 存储了当前计算好的路径信息，而 .corners 属性将这个路径简化成一系列的关键拐点（从起点，到每个转弯点，最后到终点）。直接用这些点来画线，比用密密麻麻的每帧位置要高效、平滑得多。
  2. NavMesh.SamplePosition 的重要性：原始文章里直接用 hit.point 设置目标。这在简单平面没问题，但如果你的地面不平整，或者点击点稍微偏离了导航网格，SetDestination 可能会失败。NavMesh.SamplePosition 的作用是在点击点周围一定范围内（这里1.0单位）寻找最近的、有效的导航网格位置，确保目标点一定是角色能走到的。这是一个非常实用的健壮性优化。
  3. _agent.hasPath 检查：在更新画线前，一定要检查代理是否有一条有效的路径。否则在路径计算中或目标无效时，corners 可能是空的，直接使用会报错。
  4. 性能小贴士：UpdatePathVisualization 每帧都在执行。如果游戏帧率很高，或者场景中需要画线的单位很多，这可能会成为性能瓶颈。一个简单的优化是不一定每帧都更新。因为路径只有在角色开始移动、或中途被阻挡重新计算时才会改变。你可以通过检查 _agent.pathPending（路径是否在计算中）或对比本次路径ID与上次是否相同，来减少不必要的更新。

3.2 效果调试与参数调整

把脚本挂到你的角色上，运行游戏。点击地面，你应该能看到一条线从角色脚下延伸到点击点。如果没看到，按顺序检查：

  • LineRenderer组件是否成功添加？Start Width/End Width 是否太细？
  • 脚本中 _lineRenderer 是否成功获取？（可以在Start里加个Debug.Log看看）
  • 角色NavMeshAgent的 Speed 如果设为0，它会停在原地计算路径并画线，非常适合调试。实际游戏时再调回正常速度。

4. 从“能看”到“好看”：路径线的美化与高级渲染

基础线画出来了，但可能只是一条单调的白色线段。在真实的游戏里，我们需要它更醒目、更有质感，比如一条流动的能量线、一条虚线轨迹、或者带有渐变色的路径。

4.1 使用自定义Shader实现动态流动效果

原始文章提供了一个自定义Shader来实现纹理流动，这是个非常棒的效果。我来解释一下它的原理，并提供一个更易用和常见的版本。

那个Shader的核心思路是：在片段着色器里，随着时间（_Time.y）不断偏移纹理的UV坐标（i.uv.x - MoveSpeed * _Time.y），让贴图沿着线条方向“流动”起来。这非常适合表现魔法路径、未来科技感轨迹。

但对于很多新手来说，写Shader有点门槛。这里我推荐一个更简单快捷的方法：使用Unity自带的粒子系统（Particle System）来模拟流动路径。

思路是：沿着路径线，每隔一段距离生成一个粒子，并让粒子朝着路径方向移动和消失，形成连续的流动感。虽然性能开销比Shader大，但配置灵活，效果丰富，无需编写Shader代码。你可以调整粒子的形状（可以用细长的贴图模拟线条）、颜色、大小、速度来达到想要的效果。

4.2 使用材质与颜色增强表现力

即使不用复杂Shader，单纯通过调整LineRenderer的材质和颜色也能大幅提升视觉效果。

  1. 渐变与透明度：在LineRenderer组件里，你可以设置 Color 为一个渐变（Gradient）。比如，让路径起点是明亮的绿色（Color.green），终点是淡出的蓝色（new Color(0, 0.5f, 1f, 0)）。终点的Alpha值为0，可以实现路径末端的淡出效果，看起来更自然。
  2. 使用发光材质：在Asset Store搜索“Particle Additive”或“Unlit/Transparent”这类Shader制作的材质，赋给LineRenderer。然后搭配HDR颜色，并在后期启用Bloom（泛光）效果，你的路径线就能在暗场景中发出耀眼的光芒。
  3. 纹理平铺与缩放：为LineRenderer的材质设置一个纹理（比如一条虚线贴图或能量条纹贴图）。通过调整材质面板上的 Tiling 参数，你可以控制贴图在整条路径上重复的次数。Tiling.X 值越大，贴图重复次数越多，图案就越密集。

这里有一个我常用的快速美化配置表，你可以直接参考：

效果目标 LineRenderer 参数设置 材质/Shader 建议
基础发光线 Start/End Color: (0,1,0,1) -> (0,0.5,1,0.5) Shader: Particles/Standard Unlit
Width: 0.15 -> 0.05 ( taper ) 开启 Emission，颜色调亮
魔法流动线 Start/End Color: 白色 Shader: 自定义（如原文）或 Particles/Additive
Texture: 一张纵向渐变的条纹贴图
在Shader中滚动UV的X或Y坐标
未来科技虚线 Start/End Color: 青色 Material: 使用一张- - -样式的虚线贴图
调整材质的 Tiling.X 来控制虚线密度

4.3 应对动态障碍与路径更新

游戏世界不是静止的。一扇门可能打开，一个箱子可能被推开。当导航网格发生变化时，NavMeshAgent会自动重新计算路径。我们的可视化系统也需要能响应这种变化。

幸运的是，我们之前的 UpdatePathVisualization 每帧都在用最新的 _agent.path.corners 更新线条，所以对于动态障碍物，只要NavMeshAgent的路径更新了，我们的线就会自动更新。

但这里有个高级技巧：局部避障（Local Avoidance）。当两个使用NavMeshAgent的角色面对面行走时，你希望它们能稍微绕开对方，而不是僵住或严格按照原路径碰撞。这需要用到NavMeshAgent的 obstacleAvoidanceType 和 radius 参数。设置合理的避障类型和半径，角色在行走时就会更“智能”。虽然这主要影响移动行为，但重新计算出的、带有避让的路径也会实时反映在我们的路径线上，让可视化结果更加真实。

5. 性能优化与实战技巧：让系统稳定高效

当你的游戏里有几十上百个单位都需要路径可视化时，如果不加优化，Draw Call（绘制调用）会暴增，严重拖累性能。下面是我在实际项目中总结的几个关键优化点。

5.1 按需更新与距离裁剪

最直接的优化就是不要每帧为所有单位更新路径线。

  • 按需更新：只为玩家当前选中的单位，或者正在接受命令的单位更新路径线。其他闲置单位的路径线可以隐藏（_lineRenderer.enabled = false）或直接不计算。
  • 距离裁剪：如果单位距离摄像机非常远，那条细小的路径线玩家根本看不清。可以通过计算单位与摄像机的距离，当距离超过某个阈值时，就停止更新或隐藏LineRenderer。
  • 状态检查：在 UpdatePathVisualization 方法开头增加更多判断。例如，如果代理已经到达目的地（_agent.remainingDistance < _agent.stoppingDistance），并且没有新路径，就清空并隐藏线条。
void UpdatePathVisualization()
{
    // 距离裁剪示例
    float distToCamera = Vector3.Distance(transform.position, Camera.main.transform.position);
    if (distToCamera > 50f) // 超过50个单位不显示
    {
        _lineRenderer.enabled = false;
        return;
    }
    else
    {
        _lineRenderer.enabled = true;
    }

    // ... 原有的路径更新逻辑
}

5.2 合并绘制与LOD（多层次细节）

对于大规模军团移动的场景（比如RTS游戏），为每个小兵画一条线是不可能的。这时可以采用合并绘制（Batching） 的思路。

  • 思路一：只绘制关键路径。例如，只为选中的一组单位绘制一条从队伍中心到目标点的“概括性”路径，而不是每个人的路径。
  • 思路二：使用更简单的渲染方式。对于远处的单位，可以用一个简单的Sprite（一个箭头图标）代替复杂的LineRenderer，表示移动方向即可。这就是图形学里的LOD概念，根据重要性选择不同精度的模型。

5.3 常见问题排查与调试

  1. 路径线不出现或闪烁：

    • 检查：NavMeshAgent 是否真的成功设置了目标点？在 SetDestination 后，打印 _agent.pathStatus 看看是否是 NavMeshPathStatus.PathComplete。
    • 检查：LineRenderer 的 Position Count 是否在非零时被正确设置了？在 Update 中通过 Debug.Log(corners.Length) 确认。
    • 检查：是否有多余的脚本或动画在干扰物体的Transform？确保NavMeshAgent控制移动时，不要有其他力同时作用在Rigidbody上（如果用了物理组件）。

  2. 路径线穿墙或走奇怪的地方：

    • 检查：导航网格烘焙是否正确？在Scene视图用Navigation显示模式仔细查看，蓝色区域是否覆盖了所有应行走区域，障碍物周围是否有足够空隙（Agent Radius）。
    • 检查：角色和障碍物的碰撞体（Collider）是否设置正确？NavMesh烘焙主要依赖物体的几何和Static标记，但运行时碰撞也会影响寻路感知。

  3. 性能问题：

    • 使用Profiler：Unity的Profiler (Window > Analysis > Profiler) 是你的最佳伙伴。在游戏运行时打开它，查看 Rendering 部分下的 SetPass Calls 和 Batches。如果为每个单位画线导致Batch数激增，就需要考虑上面提到的合并绘制或按需渲染优化了。

路径可视化不是一个“一次性”功能，它需要根据你的游戏类型和美术风格不断调整和打磨。从最基础的画线开始，逐步加入动态效果、优化性能，最终让它成为你游戏用户体验中一个无缝、流畅的组成部分。多试试不同的参数，看看别人优秀的游戏是怎么做的，相信你也能做出令人眼前一亮的寻路效果。

# 游戏开发
Logo
AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

cover

从「能说」到「能做」：一份理清 AI Agent 的学习笔记

avatar AI Agent技术社区
cover

DeepSeek Harness 深度解析：一切皆插件的开源 AI Agent 框架如何运行？

avatar AI Agent技术社区
cover

2026年，集团企业想要AI落地，选RPA还是Agent？

avatar AI Agent技术社区