Godot 节点与场景（4.x）

你在解决什么问题

Godot 里游戏结构几乎都落在 节点树 和 .tscn 场景 上：子弹、敌人、UI 要运行时反复实例化；get_node()、$Path 突然返回 null，或报错 「Attempt to call on a previously freed instance」，往往和路径、生命周期、同一帧内 free() 有关。本技能面向 Godot 4.3+，聚焦「怎么拆场景、怎么实例化、怎么安全访问树」，而不是 GDScript 语法、信号解耦或物理碰撞（那些应交给对应专项技能）。

技能如何组织工作流

1. 组合优于深继承：小场景（Player、Bullet、Enemy）各自单一职责，再拼成更大场景；根节点挂脚本并暴露 @export，存盘后即可作为 PackedScene 复用。
2. 运行时实例化：preload/load → scene.instantiate() → add_child(instance)；位置与状态可在 add_child 前后设置，但子节点 _ready() 与 @onready 只在入树之后 才可靠。
3. 安全访问节点：固定子节点用 @onready var x = $Path；深层引用用 唯一名 %Name（右键 Access as Unique Name），避免改名/改父级后路径失效；可选节点用 get_node_or_null()，释放后用 queue_free() + is_instance_valid()。
4. Autoload 全局服务：在 Project Settings > Globals 注册游戏状态、音频、切场景等；注意 列表顺序——Autoload 在主场景之前加载，不能假设主场景已存在。
5. 切场景：Godot 4 使用 instantiate()（非 3.x 的 instance()）；change_scene_to_file() 延迟到帧末 执行，调用后同一帧内仍是旧树，新场景节点应在下一帧或新场景 _ready() 里再读。

适用边界与常见坑

• $Path / get_node() 为 null：路径错、节点尚未入树——核对场景结构，或改用 @onready / 唯一名 / get_node_or_null()。
• 同一帧 free()：易让其它脚本仍持有引用时崩溃；优先 queue_free()。
• 与相关技能的分工：语言与 @onready 生命周期 → godot-gdscript；实例与生成器解耦 → godot-signals-groups；跨实例共享数据 → godot-resources；存档 → save-systems。场景继承、owner、groups 与路径边界案例见技能内 references/tree-and-instancing.md。