技能介绍

先说清楚要解决的问题

Godot 里几乎所有东西都是节点,但“会写节点”和“能把节点组织好”是两回事。这个技能针对的是几类反复出现的翻车场景:

$Path 或 get_node() 返回 null,或者报 "Attempt to call on a previously freed instance";
只是改了个节点名字,整棵子树的引用跟着全部失效;
想复用一个功能,最后却写成了又深又长的继承链;
运行时刷怪、发射子弹、切换场景,结果在当前帧就访问了一个已经被释放、或者还没进树的节点。

核心能力

技能把“组合优于继承”落在具体操作上:把 Player、Bullet、Enemy 拆成职责单一的小场景(.tscn),再在更大的场景里把它们拼起来。给根节点挂上脚本并暴露 @export 配置项,保存后就成为一个可以反复 instantiate() 的 PackedScene。

运行时实例化的流程很明确:preload/load → scene.instantiate() → add_child(instance),位置和状态在加入树之前或之后设置都行。节点访问则按场景区分:固定子节点用 @onready var x = $Path,深层节点改用唯一名称(%Name),可选节点用 get_node_or_null(),并且永远不要假设节点仍然存在。全局状态交给 autoload 单例,在 Project Settings > Globals 里注册,各处按名字取用。释放一律用 queue_free() 到帧末再删,事后访问前用 is_instance_valid() 兜底。

几个必须记住的坑

free() 不要在帧中调用,其他代码可能还在用这个节点;优先 queue_free(),之后用 is_instance_valid() 判断。
子节点的 _ready() 只有在进入树之后才会运行,在此之前不要期待它的 @onready 变量已经就绪。
instance() 在 Godot 4 已改名为 instantiate();preload 在解析期执行(路径必须是常量),load 在运行时执行(路径可以是变量)。
change_scene_to_file() 是延迟的,调用之后的代码仍然作用在旧树上,get_tree().current_scene 要到下一帧才指向新场景;要读新场景的节点,请在新场景的 _ready() 里做。
autoload 的加入顺序有意义,它们按列表顺序在主场景之前加载,不能依赖主场景已经存在。

适用范围

它不处理 GDScript 语法与生命周期(那是 godot-gdscript 的职责),不做基于信号的解耦(见 godot-signals-groups),也不涉及物理体与碰撞(见 godot-physics)。更细的主题,比如场景继承、owner 与所有权、groups 与唯一名称的区别、node path 的边界情况,资料指向 references/tree-and-instancing.md。