Godot UI 控件与响应式布局

它解决什么问题

在 Godot 里做 UI 时，常见三类坑：用 Node2D 摆按钮和标签，导致主题样式不继承、控件拿不到焦点；窗口尺寸一变，界面元素纹丝不动；手柄或键盘玩家无法在菜单项之间移动。这个技能把 Control 节点体系的正确用法整理成一条可执行的流程。

核心能力与工作流

1. 用 Control 而不是 Node2D 做 UI。Control 自带矩形（位置 + 尺寸）、锚点，并参与主题与焦点系统。
2. 用锚点做响应式。锚点是父矩形的 0–1 分数，优先用编辑器的 Layout 预设（Full Rect、Center 等），而不是手摆像素。
3. 让容器管子节点位置。把子控件放进 VBoxContainer、HBoxContainer、GridContainer 或 MarginContainer，通过 size_flags 控制伸缩；容器内的子节点不要自己设锚点，会被覆盖。
4. 用 Theme 集中样式。在顶层 Control 上挂 Theme 资源，子树继承；只在必要时用 add_theme_* 做单节点覆盖。
5. 接好焦点导航。设置默认聚焦控件，调用 grab_focus()，配置 focus_neighbors 或依赖 auto-neighbor，并确认 focus_mode 不是 FOCUS_NONE。
6. 连接信号：pressed、toggled、text_submitted、value_changed 等。

适用边界与注意点

• 不要用 Control 做世界中的 2D 元素（精灵、背景），那属于 Node2D 的场景。
• UI 过渡动画交给 Tween，输入重绑定交给 input-systems。
• 锚点是分数，偏移是锚点之上的像素增量；只改 position 而锚点停在 0，界面不会随窗口缩放。
• Godot 3 的 rect_size / rect_position / rect_min_size 在 4.x 已改名为 size / position / custom_minimum_size。
• 整矩形的装饰性面板要设 MOUSE_FILTER_IGNORE，否则会吞掉下层节点的点击。