Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
优化导航性能
常见的与导航相关的性能问题可分为以下主题：
烘焙导航网格时解析场景树节点的性能问题。
实际烘焙导航网格时的性能问题。
NavigationAgent 路径查询的性能问题。
实际路径搜索的性能问题。
同步导航地图的性能问题。
在以下部分中可以找到有关如何识别和修复（或至少减轻）其对帧率影响的信息。
解析场景树节点的性能问题
小技巧
建议使用边数尽可能少的简单形状，避免使用圆形、球体或圆环等圆滑的形状。
建议优先使用物理碰撞形状而不是复杂的视觉网格作为源几何体，因为网格需要从 GPU 复制，并且通常不必要地过于详细。
一般来说，应避免使用非常复杂的几何体作为烘焙导航网格的源几何体。例如，切勿使用细节丰富的视觉网格，因为将其形状解析为数据数组并体素化以供导航网格烘焙将花费大量时间，而最终导航网格的质量却得不到真正提升。相反，应使用形状高度简化的细节层次版本。更好的做法是，使用非常原始的形体（例如盒子和矩形）来大致覆盖原几何体，这样既能显著缩短烘焙时间，又能获得足以满足寻路需求的导航网格。
建议优先使用简单的物理碰撞形状而不是视觉网格作为烘焙导航网格的源几何体。默认情况下，物理形状是非常有限且经过优化的形状，可以轻松快速地解析。相比之下，视觉网格可以十分简单，也可以十分复杂。更重要的是，为了访问视觉网格数据，解析器需要从渲染服务器请求网格数据数组，因为视觉网格数据直接存储在 GPU 上，而不是缓存在 CPU 上。这需要锁定渲染服务器线程，在渲染以多线程运行时会严重影响运行时的帧率。而如果渲染以单线程运行，帧率影响可能会更严重，网格解析可能会在复杂网格上冻结整个游戏几秒钟。
实际路径搜索的性能问题
小技巧
通过减少多边形和边的数量来优化过于详细的导航网格。
实际路径搜索的成本与导航网格多边形和边缘的数量直接相关，而不是与游戏世界的实际大小相关。如果一个巨大的游戏世界使用非常优化的导航网格，只有少数多边形覆盖大面积，那么性能应该是可以接受的。如果游戏世界被分割成非常小的导航网格，每个导航网格都有微小的多边形（如 TileMap），则寻路性能将会降低。
一个常见问题是当路径查询中无法到达目标位置时性能突然下降。这种性能下降是“正常的”，是导航网格太大、未经优化，需要搜索大量多边形和边的结果。在可以快速到达目标位置的正常路径搜索中，一旦到达该位置，寻路就会提前退出，暂时隐藏这种优化不足的情况。如果无法到达目标位置，则寻路必须对现有多边形进行更久的搜索，以确认该位置绝对无法到达。