Godot UI 容器脚本库：响应式布局、自动网格、性能优化与高级容器解决方案

绝对不要在容器中手动设置子节点的 position 或 size — 容器在 queue_sort() 期间会覆盖子节点的变换。请改用 custom_minimum_size 或 size_flags [1]。
绝对不要忘记设置用于扩展的 size_flags — 默认值是 SIZE_SHRINK_BEGIN。除非你为响应式容器设置 SIZE_EXPAND_FILL，否则子节点将保持微小尺寸。
绝对不要在不设置 columns 的情况下使用 GridContainer — 默认值为 1，这会创建一个简单的垂直列表。对于响应式换行，请改用 HFlowContainer [8]。
绝对不要嵌套容器过深（10 层以上） — 深度嵌套会导致布局重新计算峰值。对于静态边距，请用 Anchor 布局替换中间容器 [16]。
绝对不要跳过间距覆盖 — 默认主题间距通常太紧凑。使用 add_theme_constant_override("separation", value) 来获得专业的呼吸空间。
绝对不要在没有最小尺寸的情况下使用 ScrollContainer — 没有它，容器可能会坍缩为零或无限扩展，破坏滚动机制。
绝对不要在同一帧滚动到新添加的子节点 — 布局尚未更新。你必须在设置 scroll_vertical 之前 await get_tree().process_frame [5]。
绝对不要缩放 SubViewportContainer 来改变其大小 — 这会扭曲渲染内容。请调整边距或使用 stretch 和 stretch_shrink 属性代替 [2]。
绝对不要将分层 Viewport 的 mouse_filter 保持为默认值 — 输入事件可能无法传递给子节点。使用 MOUSE_FILTER_PASS 或 STOP 以确保事件能向下传递 [6]。
绝对不要使用 GridContainer 进行响应式换行 — 如果你希望项目基于宽度换行，请使用 HFlowContainer。GridContainer 强制执行严格的列数 [7]。
绝对不要在容器内直接对 position 进行动画处理 — 在过渡期间，使用 Tween 对 custom_minimum_size 进行动画处理，以平滑地"推动"兄弟节点 [1]。

# VBoxContainer 示例
# 自动垂直堆叠子节点
# 子节点：
#   Button ("Play")
#   Button ("Settings")
#   Button ("Quit")

# 设置项目之间的间距
$VBoxContainer.add_theme_constant_override("separation", 10)

# 使用锚点和尺寸标志
func _ready() -> void:
    # 扩展以填满父节点
    $MarginContainer.set_anchors_preset(Control.PRESET_FULL_RECT)
    
    # 添加边距
    $MarginContainer.add_theme_constant_override("margin_left", 20)
    $MarginContainer.add_theme_constant_override("margin_right", 20)

# 控制子节点在容器中的扩展方式
button.size_flags_horizontal = Control.SIZE_EXPAND_FILL
button.size_flags_vertical = Control.SIZE_SHRINK_CENTER

主技能：godot-master

2026 年 2 月 10 日

🇺🇸English

UI Containers

Container auto-layout, size flags, anchors, and split ratios define responsive UI systems.

Available Scripts

responsive_layout_builder.gd

Expert container builder with breakpoint-based responsive layouts.

responsive_grid.gd

Auto-adjusting GridContainer that changes column count based on available width.

responsive_inventory_grid.gd

Expert logic for dynamic Grid columns based on available width and item minimum size.

terminal_autoscroll.gd

Safe ScrollContainer management. Handles the common "one-frame delay" bug when adding logs or chat.

viewport_3d_preview.gd

High-performance 3D-in-UI setup. Uses stretch_shrink and transparent_bg for character previews.

dynamic_tab_manager.gd

Pattern for dynamic tab spawning, custom titles, and tab closing logic.

responsive_tag_cloud.gd

Wrapping item lists using HFlowContainer, essential for tag clouds and responsive menus.

performance_anchor_layout.gd

Optimization architecture. Replaces deep container nesting with lightweight Anchor and Offset logic.

custom_radial_container.gd

Expert custom container logic implementing a radial/circle layout via NOTIFICATION_SORT_CHILDREN.

animated_container_shuffle.gd

Dynamic sibling reordering and animation logic for interactive UI lists.

aspect_ratio_mini_map.gd

Enforcing strict aspect ratios (e.g. 1:1, 16:9) across fluid window resizes using AspectRatioContainer.

container_size_flags_pro.gd

Advanced sizing logic using SIZE_EXPAND_FILL and stretch_ratio for weighted layouts.

NEVER Do in UI Containers

NEVER manually set childposition or size in a Container — Containers override child transforms during queue_sort(). Use custom_minimum_size or size_flags instead [1].
NEVER forgetsize_flags for expansion — Default is SIZE_SHRINK_BEGIN. Children will stay tiny unless you set SIZE_EXPAND_FILL for responsive containers.
NEVER useGridContainer without setting columns — Default is 1, creating a simple vertical list. For responsive wrapping, use instead [8].

# VBoxContainer example
# Automatically stacks children vertically
# Children:
#   Button ("Play")
#   Button ("Settings")
#   Button ("Quit")

# Set separation between items
$VBoxContainer.add_theme_constant_override("separation", 10)

Responsive Layout

# Use anchors and size flags
func _ready() -> void:
    # Expand to fill parent
    $MarginContainer.set_anchors_preset(Control.PRESET_FULL_RECT)
    
    # Add margins
    $MarginContainer.add_theme_constant_override("margin_left", 20)
    $MarginContainer.add_theme_constant_override("margin_right", 20)

SizeFlags

# Control how children expand in containers
button.size_flags_horizontal = Control.SIZE_EXPAND_FILL
button.size_flags_vertical = Control.SIZE_SHRINK_CENTER

Reference

Godot Docs: GUI Containers

Master Skill: godot-master

Weekly Installs

Repository

thedivergentai/…c-skills

GitHub Stars

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode70

codex69

gemini-cli69

github-copilot68

kimi-cli67

amp67

TanStack Query v5 完全指南：React 数据管理、乐观更新、离线支持

2,500 周安装

NEVER nest containers too deeply (10+ levels) — Heavy nesting causes layout recalculation spikes. Replace intermediate containers with Anchor Layouts for static padding [16].

NEVER skip separation overrides — Default theme separation is often too tight. Use add_theme_constant_override("separation", value) for professional breathing room.

NEVER useScrollContainer without a minimum size — Without it, the container may collapse to zero or expand infinitely, breaking the scroll mechanism.

NEVER scroll to a new child on the same frame it was added — The layout hasn't updated yet. You MUST await get_tree().process_frame before setting scroll_vertical [5].

NEVER scale aSubViewportContainer to change its size — This distorts the rendered contents. Adjust margins or use stretch and stretch_shrink properties instead [2].

NEVER leavemouse_filter on default for layered Viewports — Input events might not reach children. Use MOUSE_FILTER_PASS or STOP to ensure events drill down [6].

NEVER useGridContainer for responsive wrapping — Use HFlowContainer if you want items to wrap based on width. GridContainer enforces a strict column count [7].

NEVER animateposition directly inside a container — Use Tween on custom_minimum_size to smoothly "push" siblings during transitions [1].

Godot UI 容器脚本库：响应式布局、自动网格、性能优化与高级容器解决方案

🇨🇳中文介绍

UI 容器

可用脚本

相关 Skills

UI 容器中绝对不要做的事

响应式布局

尺寸标志

参考

相关