用途:在 Godot 4.7 中编写事件驱动、松耦合的游戏逻辑。当一个节点需要通知其他节点“某事发生”(玩家死亡、拾取物品、清完一波敌人)但不想持有对方直接引用时使用信号;当需要一次性操作某一类节点(“暂停所有敌人”“保存所有检查点”)时使用节点组。基础信号语法见 godot-gdscript,场景结构与实例化见 godot-nodes-scenes,跨场景全局事件应从 autoload 发出。
核心流程:子节点/子场景向上发出信号,由父节点连接,使子节点可复用且不知道谁在监听;在发出者上声明带类型的信号并在事件发生时 emit;用 Callable 连接(sig.connect(_on_sig)),可选在编辑器 Node 面板连接,用 CONNECT_ONE_SHOT 实现只触发一次,用 bind() 附带额外上下文;用组广播,迭代 get_tree().get_nodes_in_group(...) 或调用 call_group(...);必要时断开连接并在连接前用 is_connected() 检查以避免重复连接。
常见模式:可复用拾取物声明 signal collected(value: int),检测到玩家后 collected.emit(10) 并 queue_free(),由关卡父节点统一连接记账;连接标志如 $Door.opened.connect(_on_door_opened, CONNECT_ONE_SHOT) 与 $RedButton.pressed.connect(_on_button.bind("red"));组广播如 get_tree().call_group("enemies", "set_paused", true) 与 get_nodes_in_group("enemies").size(),用 add_to_group/remove_from_group 管理成员;用 await $AnimationPlayer.animation_finished 内联等待信号。
主要陷阱:3.x 的 connect("died", self, "_on_died") 写法已废弃,应改为 died.connect(_on_died),目标由 Callable 隐含;重复连接会让处理函数多次触发,建议 if not sig.is_connected(cb): sig.connect(cb);连接已释放节点会报错,对长生命周期监听者需断开,或依赖 Godot 在节点释放时自动断开;组是 SceneTree 全局的而非按场景隔离,同名组会共享成员,必要时给组名加命名空间;call_group 会静默忽略没有该方法的节点,方法名拼写错误不会报错,契约重要时优先用带类型的信号;信号参数数量与类型必须匹配,否则报错。