技能介绍

要解决的问题

在 Godot 里做 UI，最常见的坑是拿 Node2D 拼 HUD 或菜单，结果按钮不继承主题、键盘和手柄焦点完全失效；另一个高频问题是窗口缩放后界面错位——靠手写像素坐标摆的位置，换个分辨率就全部跑偏。这个技能专门处理这两类问题：基于 Control 节点的响应式布局、统一的主题样式，以及手柄/键盘可导航的界面结构，面向 Godot 4.3+。

核心能力与工作流程

技能的核心工作流分六步：

用 Control 而不是 Node2D 做 UI：Control 自带矩形（位置+尺寸）、锚点系统，并参与焦点与主题继承，这是后续一切的基础。
锚点负责响应式：锚点是父矩形 0–1 的比例值，四边吸附到父级边缘。用编辑器的 Layout 预设（Top-Left、Full Rect、Center 等）代替手摆像素。
容器负责子节点定位：VBoxContainer、HBoxContainer、GridContainer、MarginContainer 等容器自动摆放子节点，通过 size_flags 控制伸缩；容器内的子节点不要再手动设锚点——会被覆盖。
主题统一样式：在顶层 Control 上分配 Theme 资源，子节点自动继承；仅在必要时做单节点 theme override。
接好焦点导航：设置默认聚焦控件，定义焦点邻居或依赖 auto-neighbor，让手柄/键盘能在按钮间移动。
连接信号：pressed、toggled、text_submitted、value_changed 等事件接到游戏逻辑上。

适用边界与注意点

明确不适合的场景：世界中的 2D 节点（Node2D/精灵）属于场景搭建技能的范畴；UI 过渡动画交给 Tween（godot-animation）；卡牌手牌等类型化界面另有模板。此外有几个高频坑要避开：

别在容器里手动摆位置——容器会覆盖子节点的锚点，需要自由摆放就脱离容器，或用普通 Control/PanelContainer 包裹。
锚点与偏移是两回事：锚点是父级比例，偏移是像素增量；只设 position 而锚点停在 0，界面不会随窗口缩放。
手柄无焦点则方向输入无效——记得调用 grab_focus() 并确认 focus_mode 不是 FOCUS_NONE。
Godot 3 的属性名已改名：rect_size/rect_position/rect_min_size 在 4.x 中变为 size/position/custom_minimum_size。
全矩形装饰面板要设 MOUSE_FILTER_IGNORE，否则会吞掉下层节点的点击。