最后同步日期：2026-04-15 | Godot 官方原文 — CollisionObject3D

CollisionObject3D

节点继承关系

继承链：Node → Node3D → CollisionObject3D

Node3D

类型	名称	说明
属性	Position	本地位置（X / Y / Z）
属性	GlobalPosition	全局位置
属性	Rotation	旋转角度（欧拉角，弧度）
属性	Scale	缩放比例
属性	TopLevel	是否脱离父节点的变换
方法	LookAt()	朝向目标点
方法	ToGlobal()	本地坐标转全局坐标
方法	ToLocal()	全局坐标转本地坐标
方法	RotateX/Y/Z()	绕指定轴旋转

Node

类型	名称	说明
属性	Name	节点名称
属性	ProcessMode	处理模式（始终 / 暂停时 / 仅编辑器）
属性	ProcessPriority	处理优先级，数字越小越先执行
信号	ready	节点进入场景树并准备就绪
信号	tree_entered	节点进入场景树
信号	tree_exited	节点完全离开场景树
方法	GetNode<T>()	按路径获取子节点
方法	AddChild()	添加子节点
方法	RemoveChild()	移除子节点
方法	QueueFree()	帧结束后释放节点
方法	GetParent()	获取父节点

定义

所有 3D 碰撞对象的"老祖宗"——一个抽象基类。无论是物理体（PhysicsBody3D）还是区域检测器（Area3D），都继承自它。

打个比方：CollisionObject3D 就像是"所有能参与碰撞的东西"的统称。它下面的两个主要分支——PhysicsBody3D（物理体）和 Area3D（区域），分别代表了"能被碰撞推动的东西"和"能检测碰撞但不被推动的东西"。

使用频率：★★★★ 维度专用常用——不直接使用。这是理解 3D 碰撞系统继承关系的关键节点。

节点用途

• 不直接使用，作为所有 3D 碰撞对象的基类
• 理解碰撞系统共同属性的基础

派生节点一览

派生节点	说明	链接
PhysicsBody3D	3D 物理体基类	★★★
Area3D	3D 区域检测器	★★★

所有子类共享的属性

属性	类型	默认值	说明
CollisionLayer	uint	1	所在碰撞层（用位掩码表示）
CollisionMask	uint	1	检测哪些碰撞层（用位掩码表示）
DisableMode	int	0	禁用时的碰撞行为