Control.set_focus_neighbor如何获取目标节点的正确路径？

1. 该方法需要的路径类型 #

set_focus_neighbor仅支持两种路径格式：

• 绝对路径：以/开头的完整节点路径，从根节点/root开始定位，比如/root/UI/MainMenu/Option2。这种路径不受调用节点位置影响，是最稳妥的选择。
• 相对路径：基于调用此方法的节点的相对位置路径，比如当前节点在/root/UI/MainMenu/Option1，同父节点下的Option2相对路径就是Option2；若目标节点在上级目录的子节点中，路径则为../Sibling/Option2。

你之前用get_path_to得到的路径本身是正确的，但报错大概率是调用时机不对——比如在_init方法中就执行设置，此时节点还未完全挂载到场景树，路径解析自然会失败，必须等_ready阶段再操作。

2. 获取正确路径的两种实用方法 #

方法一：使用绝对路径（推荐） #

直接获取目标节点的绝对路径传入，无需纠结相对位置：

var next_item = item_list[item_index + 1]
item.set_focus_neighbor(SIDE_BOTTOM, next_item.get_path())

只要目标节点已存在于场景树中，绝对路径就不会出错。

方法二：使用相对路径（适合固定结构场景） #

确保在_ready()或后续生命周期方法中调用，再通过当前节点的get_path_to获取相对路径：

# 务必在节点进入场景树后调用，比如放在_ready()方法内
var next_item = item_list[item_index + 1]
var relative_path = item.get_path_to(next_item)
item.set_focus_neighbor(SIDE_BOTTOM, relative_path)

如果仍报错，检查目标节点是否确实在场景树中，或节点名称是否包含特殊字符（如空格、中文），尽量使用英文无空格的命名规则。

3. 为何不能直接传入节点引用 #

set_focus_neighbor设计为接收路径字符串，核心原因有两点：

• 场景序列化需求：Godot的.tscn场景文件需要保存焦点邻居的设置，节点引用无法被序列化存储到文件中，而路径字符串可以。
• 动态适配场景变化：当场景实例化、节点移动或重命名时，路径可以动态查找目标节点（当然路径变更后会失效，但这是设计上的取舍）。

如果偏好使用节点引用的写法，在Godot 4中可以直接将节点转为NodePath传入：NodePath(next_item)，本质仍是路径，但写法更直观。

内容的提问来源于stack exchange，提问作者DotFX