获取树节点 Godot - C#

在 Godot 引擎的场景中，树（Tree）是一种基本的节点类型，它可以通过节点层级、父子关系、路径等方式来组织和管理场景中的节点。在很多场景下，我们需要获取到特定的节点来进行操作，这就要求我们掌握如何获取树节点。

在 Godot 中，获取树节点的方法非常简单，我们可以通过以下 3 种方式来实现：

1. 使用 GetNode 方法

节点自带方法 GetNode 可以使用节点路径参数来直接获取特定节点。此方法适用于获取树节点中直接子节点，例如下面这个简单的树结构：

Root
├── Child1
└── Child2

我们可以使用下面的代码来获取 Child1：

var child1 = GetNode("Child1");

其中，GetNode 方法接受节点路径参数，以字符串形式表示。在本例中，路径参数为“Child1”，表示获取树节点的一个直接子节点。

需要注意的是，GetNode 方法只能获取直接子节点，如果需要获取非直接子节点，需要使用 GetNodeOrNull 方法或遍历节点树。

2. 使用 GetNodeOrNull 方法

GetNodeOrNull 方法和 GetNode 方法类似，其区别在于当指定节点不存在时，GetNodeOrNull 方法会返回 null，而 GetNode 方法会抛出异常。这种差异很重要，因为在很多场景下，我们无法确保某个节点一定存在。

在本例中，如果我们尝试获取一个不存在的节点 Child3，GetNode 方法会抛出异常，而 GetNodeOrNull 方法则会返回 null。这里给出相应的代码：

var child3 = GetNodeOrNull("Child3"); // 返回 null
var child3WithException = GetNode("Child3"); // 触发异常

3. 遍历节点树

在某些情况下，获取树节点需要遍历整个节点树。例如，如果我们需要获取某个节点的祖先节点或兄弟节点，树遍历就是必须的。遍历节点树的方法也比较简单，以下代码演示了一个获取树节点父节点的示例：

var parent = this;

while (parent != null && parent.Name != "Root")
{
    parent = parent.GetParent();
}

if (parent != null)
{
    // parent 此时指向根节点
}
else
{
    // 无法找到父节点
}

在本例中，我们使用 GetParent 方法获取当前节点的父节点，然后一直向根节点遍历，直到遇到根节点或遍历完整个树。这样，我们就可以获取到该节点的父节点。

需要注意的是，遍历节点树可能会耗费大量时间，不应过度使用。

至此，本文介绍了三种常用的获取树节点的方法，每种方法都有不同的适用场景和用法。在实际开发中，应根据具体情况选择合适的方法，并注意方法的效率、可靠性和安全性。