今日速览

  • Godot 里 UI 也是节点：一切界面元素都是 Control 节点的子类，官方把它们分成两类——内容控件（Button、Label、LineEdit 等）和布局控件（各类 Container 容器）。
  • **锚点（Anchor）+ 偏移（Offset）**是 UI 自适应的核心：锚点决定控件相对父节点的参考位置（0.0~1.0），偏移决定相对锚点的像素距离；想让控件贴边、贴角、居中，都是锚点的事。
  • 复杂界面别手摆坐标：Container 容器会接管子控件的摆放，嵌套使用可拼出任意复杂且能自动缩放的布局——Godot 编辑器自己的界面就是纯容器搭出来的。
  • 进到 Container 里的子控件会「交出」手动定位权，改位置会被无视或在下一次重排时被重置；想控制分配比例要靠 Expand、Stretch Ratio 等容器尺寸选项——这是新手最常踩的坑。
  • 同一个游戏要适配桌面 16:9 和 Steam Deck 掌机 16:10，UI 不写自适应，上架后必然被差评刷屏。

核心学习内容

1. UI 一切皆 Control：先分清「内容」和「布局」

Godot 官方把 Control 节点分成两组，这是理解 UI 的第一把钥匙：

  • 内容控件：负责「显示什么」——Button（按钮）、Label（文本）、LineEdit / TextEdit（输入框）、TextureRect（贴图）、ProgressBar（进度条，血条常用）等。
  • 布局控件：负责「摆在哪」——HBoxContainer / VBoxContainer（横/竖排）、GridContainer（网格）、MarginContainer（留边距）、ScrollContainer（滚动）、TabContainer（选项卡）、PanelContainer（带背景面板）。

写代码时先问自己：这个 UI 元素是「显示内容」还是「负责排版」？一个血条 HUD = 内容（ProgressBar + Label）+ 布局（VBoxContainer 竖排）的组合。

2. 锚点 + 偏移：自适应 UI 的最小知识集

官方文档举了个场景：同一个游戏可能跑在手机、平板、掌机、台式机上，分辨率千差万别。锚点就是为此设计的：

  • 每个 Control 有四个锚点偏移：left / right / top / bottom，默认都是相对父节点左上角的像素距离。
  • 锚点值在 0.0（父节点起点）到 1.0（父节点终点）之间，0.5 是中心。把水平锚点设为 1.0，偏移就变成相对父节点右上角计算。
  • 让控件居中的经典写法：四个锚点全设 0.5，再把四个偏移设为「控件尺寸的一半（负号）」，例如宽度 100 的贴图：offset_left = -50、offset_right = 50。
  • 实战中不必手敲数字：编辑器工具栏的 Anchor Presets（锚点预设） 菜单，一键设置「贴左上角 / 贴底居中 / 四边拉满」等常用布局。
  • 锚点处理不了复杂 UI 时（RPG 背包、聊天窗、模拟经营面板），就该上 Container 了。

3. Container：把布局交给引擎

Container 的核心规则只有一条：子控件放弃手动定位，位置由容器自动计算，父容器一变尺寸，子控件全部自动重排。控制分布靠这几个「容器尺寸选项」：

  • Fill（填充）：默认开启，让控件填满分配给它的区域。
  • Expand（扩展）：尽量多占容器剩余空间；不扩展的控件会被扩展的挤到一边。
  • Stretch Ratio（拉伸比）：多个扩展控件之间按比例分空间，设 2 的控件拿到的空间是设 1 的两倍。
  • 容器可以无限嵌套（VBox 里套 HBox、MarginContainer 里套 GridContainer），复杂布局就这样一层层拼出来，且天然响应式。

4. UI 结构建议：CanvasLayer + 信号解耦

游戏 UI 的推荐做法：UI 场景挂在独立的 CanvasLayer 上（UI 永远显示在最上层、不随摄像机移动），HUD 与游戏逻辑之间用信号通信而不是直接 get_node 互相抓——玩家血量变化时发出 health_changed(value)，HUD 收到信号再刷新进度条。这样 UI 和玩法互不牵绊，删掉 HUD 游戏照样能跑，也方便 DeepSeek 分模块生成。

🎯 DeepSeek 提示词

提示词 1：生成自适应 HUD（血量 + 分数 + 金币）

适用场景：游戏内 HUD，要求在不同分辨率下自动贴边、不遮挡玩法画面。

你是一名 Godot 4 游戏 UI 专家。请为我的 2D 平台跳跃游戏生成一个 HUD 场景（GDScript 脚本 + 节点结构说明）。

需求：
1. HUD 挂在 CanvasLayer 上，显示：左上角血量 ProgressBar（0-100）、右上角金币数 Label、顶部居中分数 Label。
2. 用锚点实现自适应：血量贴左上角、金币贴右上角、分数贴顶部居中，窗口缩放时位置不变。
3. 提供脚本 Hud.gd：暴露 set_health(value)、set_coins(n)、set_score(n) 三个方法，内部用 @onready 引用节点并更新显示。

输出格式：
1. 完整的 Hud.gd 代码（带注释）
2. 节点树结构图（标注每个节点的锚点与偏移值）
3. 如何在玩家场景中调用这 3 个方法的一小段示例代码

约束：只使用 Godot 4.x 的 API；不要用任何第三方插件。

使用说明：先让 DeepSeek 出结构图再贴代码，锚点值写清楚后生成结果可直接建场景复刻。

提示词 2：生成主菜单场景（开始 / 设置 / 退出）

适用场景：游戏启动主菜单，含手柄/键盘可导航的按钮列表。

你是 Godot 4 场景搭建专家。请用 GDScript 生成一个主菜单场景的完整代码。

需求：
1. 用 VBoxContainer 垂直排列 3 个按钮：开始游戏、设置、退出。
2. 菜单整体用锚点居中，按钮之间间隔 12 像素，每个按钮最小宽度 240 像素。
3. 在 MainMenu.gd 中连接按钮 pressed 信号：开始游戏 -> get_tree().change_scene_to_file("res://scenes/Game.tscn")；退出 -> get_tree().quit()；设置先打印 "打开设置" 占位。
4. 给按钮设置 focus_neighbor 或依赖容器默认焦点顺序，确保手柄上下方向键可切换按钮、Enter 键触发。

输出格式：
1. MainMenu.gd 完整代码
2. 场景节点树（含每个按钮的 size_flags_horizontal / custom_minimum_size 设置）

约束：按钮要能被手柄操作；代码兼容 Godot 4.x。

使用说明：手柄导航是 Steam 游戏刚需（Steam Deck 玩家占独立游戏很大比例），把这条约束写进提示词，DeepSeek 就会自动处理 focus 相关细节。

提示词 3：生成暂停菜单（ESC 弹出 + 暂停游戏）

适用场景：游戏中按 ESC 弹出暂停面板，遮罩背景、释放鼠标、停止游戏逻辑。

你是 Godot 4 游戏 UI 开发者。请生成一个暂停菜单的完整实现。

需求：
1. 按 ESC 键时：get_tree().paused = true，弹出居中的 PanelContainer（内含 VBoxContainer：继续游戏、回到主菜单两个按钮），并显示半透明黑色全屏遮罩（ColorRect）。
2. 弹出后要 set_process_input 或使用 process_mode = PROCESS_MODE_WHEN_PAUSED 保证暂停时菜单仍能响应输入。
3. 点击「继续游戏」：隐藏面板、get_tree().paused = false；点击「回到主菜单」：恢复暂停并切换场景到主菜单。
4. 暂停时鼠标要可见并解锁（Input.mouse_mode = Input.MOUSE_MODE_VISIBLE），恢复时按玩家设置处理。

输出格式：
1. PauseMenu.gd 完整代码
2. 节点树结构（标注每个节点的 process_mode 设置）
3. 一段说明：如何把它作为 autoload 单例挂载以便任何场景按 ESC 都能打开

约束：Godot 4.x；注意 paused 状态下节点默认不处理输入，必须正确处理 process_mode。

使用说明：paused = true 后节点默认冻结输入是 Godot 新手最常见的翻车点，这条提示词把坑提前写进约束，DeepSeek 会给出 PROCESS_MODE_WHEN_PAUSED 的正确写法。

学习心得

今天学完 UI 后最大的感受：UI 是 AI 最难「猜」、但也最容易「说清楚」的部分。难猜是因为锚点数字、容器层级这些细节，AI 自由发挥必然跑偏；容易说清楚是因为 UI 结构天然适合文字描述——「左上角血量条、顶部居中分数、VBox 竖排三个按钮」本身就是一棵清晰的节点树。所以把 UI 需求喂给 DeepSeek 时，只要在提示词里写清「节点类型 + 锚点位置 + 容器 + 信号连接」四要素，生成结果基本能直接建场景用。这也是今天三条提示词都在强调结构、锚点、process_mode 的原因。对「用 DeepSeek 做一款能上架 Steam 的游戏」来说，UI 自适应 + 手柄导航这两关过了，玩家的第一印象（截图和试玩）就不会垮。

明日关注

  • 用提示词 1 让 DeepSeek 生成 HUD 场景，把血量 ProgressBar 和玩家 health_changed 信号接起来，在游戏里跑通
  • 用提示词 2 生成主菜单，实测手柄（或键盘方向键）能否在按钮间导航，为 Steam Deck 做准备
  • 学习 Godot Theme（主题皮肤）系统，给默认灰色 UI 换上一套风格统一的皮肤，让截图不再「一眼业余」

本文由自动化学习流水线每日生成，坚持即学即记。