【杂谈】Godot 信号命名规范

学博而后可约，事历而后知要。

一、信号命名规范

1. 过去时态描述事件

   # ✅ 正确
   signal health_changed      # 状态已改变
   signal item_collected      # 物品已收集
   signal enemy_died          # 敌人已死亡

   # ❌ 避免
   signal change_health       # 动词原形
   signal collecting_item     # 进行时态

2. 明确作用对象

   # ✅ 层级清晰
   signal player_jumped
   signal boss_phase_changed

   # ✅ 通用事件
   signal inventory_updated   # 无明确主语但领域明确

3. 参数命名清晰

   # ✅ 类型注释 + 自解释参数
   signal weapon_switched(old_weapon: Weapon, new_weapon: Weapon)

   # ❌ 模糊参数
   signal data_updated(value)  # 无类型提示

---

二、信号处理函数规范

1. 命名格式

   func _on_[发送节点名]_[信号名]():
       pass

   # 示例
   func _on_playe