信号好用，但不能没有边界
Godot 的信号系统是它最顺手的特性之一。按钮点击、角色受伤、计时器结束、资源加载完成，都可以用 signal 表达。原型阶段，脚本里随手 connect()，节点之间很快就能协作。项目做大后，信号也会变成一张看不见的网：谁监听了谁，节点释放后连接还在不在，同一个事件为什么触发两次，某个 UI 为什么在场景关闭后仍然收到通知。
Godot 4 的 typed signals 让信号更可靠，但类型只是基础。真正的问题是事件边界。信号应该表达事实，而不是把一个节点变成另一个节点的远程控制器。客户端需要约定哪些信号只在局部场景内传播，哪些事件可以跨模块，哪些必须进入领域模型。
flowchart TD
A[局部 Node 信号] --> B{是否跨场景?}
B -->|否| C[父节点/同场景监听]
B -->|是| D{是否业务事实?}
D -->|是| E[Domain Model 更新]
D -->|否| F[UI/表现层事件]
E --> G[模型发 typed signal]
G --> H[多个 UI/系统订阅]
F --> I[短生命周期连接]
H --> J[调试事件追踪]
typed signals 先把契约写清楚
Godot 4 可以给信号参数加类型，例如 signal health_changed(current: int, max: int)。这比裸信号安全很多，编辑器和运行时都更容易发现错误。团队应把核心信号都写成 typed signals，尤其是模型层、服务层和可复用控件。
类型不是为了炫技，而是为了让调用方知道事件含义。changed(value) 太模糊，inventory_slot_changed(slot_id: int, item_id: StringName, count: int) 就清楚很多。信号名和参数要描述事实，不要描述实现。button_pressed 是 UI 事实，open_shop_now 更像命令，后者通常不适合作为跨模块信号。
参数也不要直接传复杂 Node 引用。局部场景内传 Node 可以接受，跨模块事件最好传 ID 或数据对象。Node 生命周期跟场景绑定，接收方保存引用后，很容易在场景切换时访问已释放对象。
连接生命周期要可控
很多 Godot 信号问题来自连接没有断开，或者重复连接。节点 _ready() 里 connect，场景被复用或重新进入时又 connect 一次，最后一个事件触发两遍。Godot 会对重复连接有一定保护，但不能替代设计。
局部连接建议由拥有者管理。父节点实例化子节点后连接子节点信号，父节点释放时子节点一起释放，生命周期自然结束。跨服务连接则要显式注册和注销，或者在 _exit_tree() 里断开。UI 页面订阅模型变化，页面关闭时必须取消订阅，除非连接对象生命周期比页面短。
可以封装一个订阅助手，记录当前节点建立的连接，在 _exit_tree() 自动断开。这样页面开发不必每次手写一堆 disconnect，也能减少忘记清理的风险。
EventBus 不要吞掉所有信号
很多项目为了方便，会做一个全局 EventBus。任何地方发事件，任何地方收事件。它解决了节点查找问题，也制造了新的不透明问题。事件名字符串写错、订阅者太多、事件顺序不确定，调试起来很痛苦。
EventBus 应该只承接真正跨模块、短生命周期的事件，比如全局 Toast、埋点、调试通知、系统级刷新。核心业务状态更适合放在模型里：背包模型发背包变化，任务模型发任务变化，音频服务发设备变化。这样事件有归属，调试时能找到源头。
如果使用 EventBus，事件名要集中定义，载荷要结构化，调试模式要记录最近事件。不要让业务脚本手写 emit("something_happened", data)，半年后没人知道这个事件还有没有人在听。
UI 和模型之间用单向数据流
Godot UI 很容易直接监听各种玩法节点信号。比如战斗角色血量变化直接连到 HUD，任务 NPC 对话直接连到任务面板。短期简单，长期会让 UI 依赖场景结构。更稳的方式是玩法节点更新模型，模型发信号，UI 监听模型。
这样做的好处是 UI 可以重建、隐藏、换主题，而不影响玩法。HUD 关闭后再打开，只要读取模型当前状态即可，不需要等下一次角色发信号。多个 UI 也能共享同一事实来源。
模型信号要表达状态变化，而不是 UI 指令。quest_progress_changed、reward_claimable_changed、party_member_updated 都是状态变化。UI 根据状态决定显示什么。
信号调试要可视化
信号问题最难的是“看不见”。建议在开发包里记录核心信号：发出者、信号名、参数摘要、监听者数量、耗时。不要记录所有按钮点击，否则日志爆炸；只记录模型、服务和 EventBus 级事件。
调试面板可以显示最近 100 条事件流，支持按事件名过滤。遇到红点不消失、UI 重复刷新、奖励弹两次这种问题，事件流能直接告诉你哪个事件触发了几次、谁先谁后。
还可以在关键事件里加 trace id。比如一次领取奖励，从按钮点击、请求发送、背包模型更新、奖励弹窗、红点刷新，都带同一个 id。这样跨系统流程也能串起来。
小结
Godot 信号是连接节点的利器，但大型客户端需要信号纪律。typed signals 写清契约，连接生命周期可控，EventBus 只承接合适事件，业务状态回到模型，调试工具记录关键事件流。这样信号仍然保留 Godot 的灵活性，却不会把项目变成一团看不见的回调网。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
我会把信号使用规范放进代码评审清单：跨场景信号是否传 Node，UI 是否直接依赖玩法节点，EventBus 事件是否有集中定义，页面退出是否清理订阅。每条都很小，但能长期保护项目结构。
继续阅读
探索更多技术文章
浏览归档，发现更多关于系统设计、工具链和工程实践的内容。