Node节点字典
2026/4/14大约 17 分钟
最后同步日期：2026-04-15 | Godot 官方原文 — All Classes
Node节点字典
本字典按照 Godot 编辑器中 Ctrl+A（添加节点） 的 Node 树结构，系统梳理所有常用节点。
每个节点按使用频率标注：
- ★★★★★ 通用高频 — 2D 和 3D 通用，或与维度无关但几乎所有项目都会用到
- ★★★★ 常用 — 常用项目中经常用到
- ★★★ 一般常用 — 特定类型项目中经常使用
- ★★ 偶尔使用 — 特定场景才需要
- ★ 基本用不到 — 非常特殊的场景
如何使用本字典
- 先看下面的总览表，找到你需要的节点
- 点击节点名称跳转到独立页面，查看继承关系、属性列表和代码示例
- 每个节点的属性表按功能分组，继承属性标注来源并可点击跳转查看详情
分类总览
以下是 Godot 引擎中所有内置节点按功能分类的完整列表。点击分类名可查看该分类下的所有节点详情。
| 分类 | 描述 | 节点数量 | 链接 |
|---|---|---|---|
| 基础节点 | 所有节点的根基类和坐标基类 | 4 | 查看详情 |
| 显示节点 | 2D/3D 图片、文字、网格等可见内容 | 13 | 查看详情 |
| 物理碰撞节点 | 刚体、碰撞体、关节、射线检测等 | 30 | 查看详情 |
| UI 控件节点 | 按钮、输入框、容器等界面控件 | 48 | 查看详情 |
| 摄像机与光照节点 | 2D/3D 摄像机、各类光源 | 8 | 查看详情 |
| 动画节点 | 动画播放、骨骼、逆向运动学 | 12 | 查看详情 |
| 音频节点 | 音频播放器、监听器 | 5 | 查看详情 |
| 瓦片地图节点 | 2D 瓦片关卡搭建 | 2 | 查看详情 |
| 导航寻路节点 | AI 寻路区域、代理、避障 | 8 | 查看详情 |
| 粒子与环境特效节点 | 粒子系统（Particle System）、全局光照、贴花等特效 | 26 | 查看详情 |
| 网络多人节点 | 多人游戏同步、HTTP 请求 | 3 | 查看详情 |
| 工具辅助节点 | 定时器、标记点、路径、视口等工具 | 29 | 查看详情 |
| XR/VR 节点 | XR 原点、控制器、锚点 | 8 | 查看详情 |
节点分类树形图
下面用树形图直观展示所有节点的分类层级。第一张是 1-2 级总览，后面每张图展开一个分类的所有节点。点击任意节点可直接跳转到对应的详情页面。
总览（1-2 级）
基础节点
显示节点
物理碰撞节点
UI 控件节点
摄像机与光照节点
动画节点
音频节点
瓦片地图节点
导航寻路节点
粒子与环境特效节点
网络多人节点
工具辅助节点
全部节点 A-Z 索引
共收录 191 个内置节点。点击节点名称可跳转到对应的详细文档（包含继承关系、属性列表和代码示例）。支持按默认 A-Z 或使用频率排序。
| 节点名称 | 所属分类 | 描述 | 频率 ↕ 默认 |
|---|---|---|---|
AcceptDialog | UI 控件 | 确认对话框 | ★ |
AnimatableBody2D | 物理 | 2D 动画驱动物理体（平台、机关） | ★★★ |
AnimatableBody3D | 物理 | 3D 动画驱动物理体（平台、机关） | ★★★ |
AnimatedSprite2D | 显示 | 播放 2D 帧动画 | ★★★★ |
AnimatedSprite3D | 显示 | 在 3D 空间中播放帧动画 | ★★★ |
AnimationPlayer | 动画 | 播放属性动画 | ★★★★ |
AnimationTree | 动画 | 高级动画状态机（Animation State Machine） | ★★★★ |
Area2D | 物理 | 2D 检测区域（触发器） | ★★★★ |
Area3D | 物理 | 3D 检测区域（触发器） | ★★★★ |
AspectRatioContainer | UI 控件 | 保持子节点宽高比 | ★★ |
AudioListener2D | 音频 | 2D 音频监听器 | ★★ |
AudioListener3D | 音频 | 3D 音频监听器 | ★★ |
AudioStreamPlayer | 音频 | 播放非定位音频（BGM） | ★★★★★ |
AudioStreamPlayer2D | 音频 | 播放带 2D 位置的音频 | ★★★★ |
AudioStreamPlayer3D | 音频 | 播放带 3D 位置的音频 | ★★★★ |
BackBufferCopy | 工具 | 复制屏幕缓冲区（用于着色器（Shader）） | ★ |
BoneAttachment3D | 动画 | 附着到骨骼上的节点 | ★ |
Button | UI 控件 | 标准按钮 | ★★★★ |
Camera2D | 摄像机与光照 | 2D 摄像机 | ★★★★ |
Camera3D | 摄像机与光照 | 3D 摄像机 | ★★★★ |
CanvasGroup | 工具 | CanvasItem 组，统一裁剪和排序 | ★★★ |
CanvasItem | 基础 | 所有可绘制节点的基类（可见性、绘制顺序） | ★★★★ |
CanvasLayer | 工具 | 独立 2D 画布层（HUD、弹窗） | ★★★★★ |
CanvasModulate | 工具 | 给整个 2D 画布染色 | ★★ |
CCDIK3D | 动画 | CCD 逆向运动学 | ★★ |
CenterContainer | UI 控件 | 居中子节点 | ★★★ |
CharacterBody2D | 物理 | 2D 角色控制（玩家/敌人） | ★★★★ |
CharacterBody3D | 物理 | 3D 角色控制（玩家/敌人） | ★★★★ |
CheckBox | UI 控件 | 复选框 | ★★★ |
CheckButton | UI 控件 | 切换按钮 | ★★★ |
CodeEdit | UI 控件 | 代码编辑器 | ★ |
CollisionPolygon2D | 物理 | 用多边形定义 2D 碰撞 | ★★★ |
CollisionPolygon3D | 物理 | 用多边形定义 3D 碰撞 | ★★★ |
CollisionShape2D | 物理 | 定义 2D 碰撞形状 | ★★★★ |
CollisionShape3D | 物理 | 定义 3D 碰撞体积 | ★★★★ |
ColorPicker | UI 控件 | 颜色选择器 | ★★ |
ColorPickerButton | UI 控件 | 弹出颜色选择器的按钮 | ★★ |
ColorRect | UI 控件 | 色块矩形（纯色背景/遮罩） | ★★★★ |
ConeTwistJoint3D | 物理 | 3D 锥形扭转关节 | ★ |
ConfirmationDialog | UI 控件 | 确认/取消对话框 | ★ |
Control | UI 控件 | 所有 UI 控件的基类 | ★★★★★ |
CPUParticles2D | 特效 | CPU 计算 2D 粒子（兼容性好） | ★★ |
CPUParticles3D | 特效 | CPU 计算 3D 粒子（兼容性好） | ★★ |
CSGBox3D | 特效 | CSG 立方体，快速原型搭建 | ★★★ |
CSGCombiner3D | 特效 | CSG 组合器，合并多个 CSG 形状 | ★★★ |
CSGCylinder3D | 特效 | CSG 圆柱体 | ★★★ |
CSGMesh3D | 特效 | CSG 自定义网格 | ★★ |
CSGPolygon3D | 特效 | CSG 多边形挤出 | ★★ |
CSGShape3D | 特效 | 构造实体几何（快速原型搭建） | ★★★ |
CSGSphere3D | 特效 | CSG 球体 | ★★★ |
CSGTorus3D | 特效 | CSG 环形 | ★★ |
DampedSpringJoint2D | 物理 | 2D 阻尼弹簧关节 | ★ |
Decal | 特效 | 贴花（弹孔、血迹等） | ★★ |
DirectionalLight2D | 摄像机与光照 | 2D 平行光 | ★★★★ |
DirectionalLight3D | 摄像机与光照 | 平行光（太阳光） | ★★★★ |
FABRIK3D | 动画 | FABRIK 逆向运动学 | ★★ |
FileDialog | UI 控件 | 文件选择对话框 | ★★ |
FlowContainer | UI 控件 | 流式排列（自动换行） | ★★★ |
FogVolume | 特效 | 体积雾 | ★★ |
FoldableContainer | UI 控件 | 可折叠容器（Godot 4.4+） | ★★★ |
Generic6DOFJoint3D | 物理 | 3D 六自由度关节 | ★ |
GPUParticles2D | 特效 | GPU 加速 2D 粒子系统 | ★★★★ |
GPUParticles3D | 特效 | GPU 加速 3D 粒子系统 | ★★★★ |
GPUParticlesAttractor2D | 特效 | 2D GPU 粒子吸引器 | ★★ |
GPUParticlesAttractor3D | 特效 | GPU 粒子吸引器 | ★★ |
GPUParticlesCollision2D | 特效 | 2D GPU 粒子碰撞体基类 | ★★ |
GPUParticlesCollision3D | 特效 | GPU 粒子碰撞体 | ★★ |
GPUParticlesCollisionSDF2D | 特效 | 2D GPU 粒子 SDF 碰撞 | ★★ |
GPUParticlesCollisionSDF3D | 特效 | 3D GPU 粒子 SDF 碰撞 | ★★ |
GraphEdit | UI 控件 | 图形编辑器 | ★ |
GridContainer | UI 控件 | 网格排列子节点 | ★★★ |
GridMap | 特效 | 3D 网格地图 | ★★ |
GrooveJoint2D | 物理 | 2D 滑槽关节 | ★ |
HBoxContainer | UI 控件 | 水平排列子节点 | ★★★★ |
HingeJoint3D | 物理 | 3D 铰链关节 | ★ |
HSplitContainer | UI 控件 | 水平分割容器 | ★★★ |
HTTPRequest | 网络 | 发送 HTTP 请求（REST API、下载） | ★★★★ |
InstancePlaceholder | 工具 | 占位节点（延迟加载场景） | ★ |
ItemList | UI 控件 | 项目列表 | ★★★ |
Label | 显示 | 显示 2D 文字 | ★★★★ |
Label3D | 显示 | 在 3D 空间中显示文字 | ★★★ |
LightmapGI | 特效 | 烘焙全局光照 | ★★ |
LightOccluder2D | 摄像机与光照 | 2D 阴影遮挡体（投射阴影） | ★★ |
Line2D | 显示 | 绘制 2D 线条 | ★★★ |
LineEdit | UI 控件 | 单行文本输入 | ★★★★ |
LinkButton | UI 控件 | 超链接风格按钮 | ★ |
MarginContainer | UI 控件 | 给子节点加边距 | ★★★ |
Marker2D | 工具 | 2D 标记点（武器发射位置等） | ★★★★ |
Marker3D | 工具 | 3D 标记点 | ★★★★ |
MenuButton | UI 控件 | 带下拉菜单的按钮 | ★★ |
MeshInstance2D | 显示 | 在 2D 空间中显示网格 | ★★ |
MeshInstance3D | 显示 | 在 3D 空间中显示模型 | ★★★★ |
MultiMeshInstance2D | 显示 | 高效批量绘制大量 2D 网格 | ★★ |
MultiMeshInstance3D | 显示 | 高效批量绘制大量 3D 模型 | ★★ |
MultiplayerSpawner | 网络 | 多人游戏中自动生成节点 | ★★ |
MultiplayerSynchronizer | 网络 | 多人游戏中同步节点属性 | ★★ |
NavigationAgent2D | 导航 | 2D AI 寻路代理 | ★★★ |
NavigationAgent3D | 导航 | 3D AI 寻路代理 | ★★★ |
NavigationLink2D | 导航 | 2D 导航连接点（跳跃、梯子） | ★★ |
NavigationLink3D | 导航 | 3D 导航连接点（跳跃、梯子） | ★★ |
NavigationObstacle2D | 导航 | 2D 动态避障物 | ★★ |
NavigationObstacle3D | 导航 | 3D 动态避障物 | ★★ |
NavigationRegion2D | 导航 | 定义 2D 可行走区域 | ★★★★ |
NavigationRegion3D | 导航 | 定义 3D 可行走区域 | ★★★★ |
NinePatchRect | UI 控件 | 可拉伸的九宫格图片 | ★★★★ |
Node | 基础 | 所有节点的根基类，纯逻辑容器 | ★★★★★ |
Node2D | 基础 | 所有 2D 节点的基类（位置、旋转、缩放） | ★★★★★ |
Node3D | 基础 | 所有 3D 节点的基类（位置、旋转、缩放） | ★★★★★ |
OccluderInstance3D | 特效 | 3D 遮挡剔除（Occlusion Culling）实例 | ★★ |
OmniLight3D | 摄像机与光照 | 点光源（灯泡） | ★★★★ |
OpenXRCompositionLayer | XR/VR | XR 合成层 | ★ |
OptionButton | UI 控件 | 下拉选择按钮 | ★★★ |
Panel | UI 控件 | 面板背景 | ★★★★ |
PanelContainer | UI 控件 | 带背景的面板容器 | ★★★ |
Parallax2D | 工具 | 新版视差滚动节点（Godot 4.3+） | ★★★ |
ParallaxBackground | 工具 | 视差滚动背景容器 | ★★★ |
ParallaxLayer | 工具 | 视差滚动层 | ★★★ |
Path2D | 工具 | 定义 2D 路径曲线 | ★★★ |
Path3D | 工具 | 定义 3D 路径曲线 | ★★★ |
PathFollow2D | 工具 | 沿 2D 路径移动 | ★★★ |
PathFollow3D | 工具 | 沿 3D 路径移动 | ★★★ |
PhysicalBone2D | 物理 | 2D 物理骨骼（布娃娃系统） | ★★★ |
PhysicalBone3D | 物理 | 3D 物理骨骼（布娃娃系统） | ★★ |
PinJoint2D | 物理 | 2D 钉住关节 | ★★ |
PointLight2D | 摄像机与光照 | 2D 点光源 | ★★★★ |
Polygon2D | 显示 | 绘制自定义 2D 多边形 | ★★★ |
PopupMenu | UI 控件 | 弹出菜单 | ★★ |
ProgressBar | UI 控件 | 进度条 | ★★★★ |
RayCast2D | 物理 | 2D 射线检测 | ★★★★ |
RayCast3D | 物理 | 3D 射线检测 | ★★★★ |
ReflectionProbe | 特效 | 环境反射探针 | ★★ |
RemoteTransform2D | 工具 | 远程同步 2D 变换 | ★★ |
RemoteTransform3D | 工具 | 远程同步 3D 变换 | ★★ |
ResourcePreloader | 工具 | 预加载资源 | ★★ |
RichTextLabel | UI 控件 | 富文本显示 | ★★★ |
RigidBody2D | 物理 | 2D 物理刚体（球、箱子） | ★★★ |
RigidBody3D | 物理 | 3D 物理刚体（球、箱子） | ★★★ |
ScrollContainer | UI 控件 | 可滚动容器 | ★★★ |
ShapeCast2D | 物理 | 2D 形状投射检测 | ★★ |
ShapeCast3D | 物理 | 3D 形状投射检测 | ★★ |
Skeleton2D | 动画 | 2D 骨骼系统（Skeleton） | ★★★ |
Skeleton3D | 动画 | 3D 骨骼系统 | ★★★ |
SkeletonIK3D | 动画 | 3D 逆向运动学 | ★★ |
SkeletonModifier3D | 动画 | 3D 骨骼修改器基类 | ★★ |
Slider | UI 控件 | 滑动条 | ★★★ |
SliderJoint3D | 物理 | 3D 滑动关节 | ★ |
SoftBody3D | 工具 | 3D 软体（布料、橡胶等） | ★ |
SpinBox | UI 控件 | 数值输入框 | ★★★ |
SplineIK3D | 动画 | 样条线 IK | ★★ |
SplitContainer | UI 控件 | 可拖动分割容器 | ★★ |
SpotLight3D | 摄像机与光照 | 聚光灯 | ★★★ |
SpringArm3D | 工具 | 3D 弹簧臂（第三人称摄像机跟随） | ★★★★ |
Sprite2D | 显示 | 显示一张 2D 图片 | ★★★★ |
Sprite3D | 显示 | 在 3D 空间中显示一张 2D 图片 | ★★★ |
StaticBody2D | 物理 | 2D 静态物体（地板、墙壁） | ★★★★ |
StaticBody3D | 物理 | 3D 静态物体（地板、墙壁） | ★★★★ |
SubViewport | 工具 | 嵌套视口（小地图、镜像等） | ★★★ |
SubViewportContainer | UI 控件 | 嵌入视口的容器 | ★★ |
TabBar | UI 控件 | 标签栏 | ★★★ |
TabContainer | UI 控件 | 标签页容器 | ★★★ |
TextEdit | UI 控件 | 多行文本编辑 | ★★★ |
TextMesh | 显示 | 将文字作为 3D 网格渲染 | ★★ |
TextureButton | UI 控件 | 用图片做按钮 | ★★★ |
TextureProgressBar | UI 控件 | 用图片做进度条 | ★★★ |
TextureRect | UI 控件 | UI 中显示图片 | ★★★★ |
TileMap | 瓦片地图 | 用瓦片拼出 2D 关卡 | ★★★★ |
TileMapLayer | 瓦片地图 | 单层瓦片地图（Godot 4.3+ 推荐） | ★★★★ |
Timer | 工具 | 定时触发信号 | ★★★★★ |
TouchScreenButton | 工具 | 移动端触屏按钮 | ★ |
Tree | UI 控件 | 树形列表 | ★★★ |
TwoBoneIK3D | 动画 | 双骨骼 IK，常用手脚着地效果 | ★★★ |
VBoxContainer | UI 控件 | 垂直排列子节点 | ★★★★ |
VehicleBody3D | 物理 | 3D 载具物理体（汽车、坦克） | ★★ |
VehicleWheel3D | 物理 | 3D 载具车轮 | ★★ |
VideoStreamPlayer | UI 控件 | 视频播放器 | ★★ |
Viewport | 工具 | 视口节点（渲染目标） | ★★★ |
VisibleOnScreenEnabler2D | 工具 | 2D 可见时启用节点 | ★★ |
VisibleOnScreenEnabler3D | 工具 | 3D 可见时启用节点 | ★★ |
VisibleOnScreenNotifier2D | 工具 | 2D 可见性通知 | ★★ |
VisibleOnScreenNotifier3D | 工具 | 3D 可见性通知 | ★★ |
VoxelGI | 特效 | 实时全局光照 | ★★ |
VSplitContainer | UI 控件 | 垂直分割容器 | ★★★ |
Window | 工具 | 独立窗口节点 | ★★ |
WorldEnvironment | 特效 | 全局环境设置（天空、雾、色调映射） | ★★★★ |
XRAnchor3D | XR/VR | XR 空间锚点 | ★ |
XRBodyModifier3D | XR/VR | XR 身体追踪修改器 | ★ |
XRCamera3D | XR/VR | XR 摄像机 | ★ |
XRController3D | XR/VR | XR 控制器（手柄位置） | ★ |
XRFaceModifier3D | XR/VR | XR 面部追踪修改器 | ★ |
XRHandModifier3D | XR/VR | XR 手部追踪修改器 | ★ |
XROrigin3D | XR/VR | XR 体验的原点 | ★ |