游戏引擎 / 系统课时
把节点放进 3D 世界坐标
把节点放进 3D 世界坐标
本课解决场景摆放时最容易混淆的问题:为什么子节点的 Position 没变,物体却跟着父节点移动。你将用一个父节点和一个立方体验证 Position、Rotation、Scale 的作用,并读出局部坐标与世界坐标。
学习目标
- 正确调整 3D 节点的 Position、Rotation 和 Scale。
- 解释父节点如何影响子节点在世界中的位置和方向。
- 用 Cocos Creator 3.8 的 Node API 验证两套坐标值。
三种变换究竟改了什么
Cocos Creator 的 3D 场景使用右手坐标系,通常 X 向右、Y 向上,默认前方为 -Z。一个节点拥有自己的局部坐标系,属性检查器中的变换值默认都相对于父节点,而不是直接相对于整个场景。
| 属性 | 常见初始值 | 实际控制 |
|---|---|---|
| Position | (0, 0, 0) |
沿父节点坐标轴的相对位移 |
| Rotation | (0, 0, 0) |
相对父节点绕 X、Y、Z 轴的欧拉角,编辑器以度显示 |
| Scale | (1, 1, 1) |
相对父节点沿三轴的缩放倍率 |
选择物体后可在属性检查器直接输入数值,也可以在场景编辑器使用移动、旋转、缩放手柄。切换手柄的 Local/Global 方向,只会改变拖动参考的轴向,不会把属性检查器里的 Position 自动改成世界坐标。
父子层级决定世界位置
设父节点 ParentPivot 的 Position 为 (10, 0, 0)、Rotation 为 (0, 0, 0)、Scale 为 (1, 1, 1);它下面的 Cube 的 Position 是 (1, 0, 0)。此时 Cube 的局部位置为 (1, 0, 0),世界位置是 (11, 0, 0)。
当父节点沿 X 轴再移动 2 个单位,Cube 的局部 Position 仍是 (1, 0, 0),但世界位置变为 (13, 0, 0)。这是父子层级传播变换的结果,不是编辑器替你修改了子节点字段。

这个直接相加的例子有前提:父节点没有旋转,缩放也是单位值。只要父节点发生旋转或缩放,子节点的局部位移还会受到父坐标轴方向和倍率影响,不能继续把三个 Position 数值简单相加。
在场景中亲手验证
- 打开一个含 Camera 的 3D 场景,在层级管理器中新建空节点并命名
ParentPivot,将其 Position 设置为(10, 0, 0),Rotation 为(0, 0, 0),Scale 为(1, 1, 1)。 - 在
ParentPivot下创建 3D 立方体并命名Cube,将其 Position 设为(1, 0, 0)。父子关系必须在层级管理器中实际成立;需要在运行时看到 Cube,还应调整 Camera 使它进入镜头范围。 - 将
ParentPivot的 Position 改为(12, 0, 0),观察 Cube 一起移动但其局部 Position 不变。再恢复父节点 X 为10,便于对照脚本输出。 - 尝试单独调整父节点 Rotation 的 Y 值和 Scale 的 X 值,观察 Cube 的位置、朝向或外观变化;实验完成后分别恢复为
0和1。保存场景。
用脚本读出两套位置
在资源管理器创建 TransformCheck.ts,使用下列完整组件脚本,并将其挂在 Cube 而不是 ParentPivot 上。预览前确保数值恢复到上一节的初始设置。
import { _decorator, Component } from 'cc';
const { ccclass } = _decorator;
@ccclass('TransformCheck')
export class TransformCheck extends Component {
start() {
// 组件挂在 Cube 上,父节点位于世界坐标 (10, 0, 0)。
const local = this.node.getPosition();
const world = this.node.getWorldPosition();
// 同时输出两套坐标,避免把局部字段误认成世界位置。
console.log(`local=(${local.x}, ${local.y}, ${local.z})`);
console.log(`world=(${world.x}, ${world.y}, ${world.z})`);
}
}预期输出(浏览器 Console 中):
local=(1, 0, 0)
world=(11, 0, 0)getPosition() 和 setPosition() 面向局部位置,getWorldPosition() 和 setWorldPosition() 面向世界位置。属性检查器显示的 Rotation 是欧拉角,脚本里的 node.eulerAngles 也可读写欧拉角;node.rotation 则是四元数,不能把两者当作相同格式。
实践中,角色身上的武器、头顶标识适合使用局部变换,以便跟随角色移动;需要把物体放在场景某个固定地点时,应明确采用世界坐标。判断一个数值的意义时,先确认它相对于谁,再决定使用哪组 API。