模块 0：Cocos Creator → Unity 迁移对照

Day 1 ⏱ 预计阅读 1.5 小时

引言：为什么学对照比从零学更快

你已经在 Cocos Creator 中掌握了游戏开发的核心概念：节点树、组件模式、游戏循环、Prefab、坐标系、资源加载。Unity 的底层逻辑完全一致，只是 API 命名、编辑器布局、语言（TypeScript → C#）不同。

本模块采用「先说你已经懂的，再告诉你 Unity 里怎么写」的策略。

0.1 编辑器概念对照

两个引擎的编辑器布局非常相似，但名称和细节不同：

0.2 组件化架构对照

两个引擎都采用组合优于继承的组件模式，但语法完全不同。

添加与获取组件

// === Cocos Creator (TypeScript) ===
import { _decorator, Component, Sprite } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('Player')
export class Player extends Component {
    onLoad() {
        // 获取已有的 Sprite 组件
        let sprite = this.node.getComponent(Sprite);
        // 添加新的组件
        let col = this.node.addComponent(BoxCollider2D);
    }
}

// === Unity (C#) ===
using UnityEngine;

public class Player : MonoBehaviour
{
    void Awake()
    {
        // 获取已有的 SpriteRenderer 组件
        SpriteRenderer sprite = GetComponent<SpriteRenderer>();
        // 添加新的组件
        BoxCollider col = gameObject.AddComponent<BoxCollider>();
    }
}

装饰器 vs 特性（Attribute）

完整对照：一个带属性的组件

// === Cocos Creator ===
@ccclass('FarmManager')
export class FarmManager extends Component {
    @property(Node)
    playerNode: Node = null;
    @property({ type: Prefab })
    cropPrefab: Prefab = null;
    @property
    gold: number = 100;
    @property({ min: 1, max: 10 })
    cropGrowSpeed: number = 3;

    start() {
        let crop = instantiate(this.cropPrefab);
        crop.setParent(this.node);
    }
}

// === Unity (C#) ===
public class FarmManager : MonoBehaviour
{
    public GameObject playerNode;     // 拖拽赋值
    public GameObject cropPrefab;     // 拖拽 Prefab 赋值
    public int gold = 100;
    [Range(1, 10)]
    public float cropGrowSpeed = 3f;

    void Start()
    {
        GameObject crop = Instantiate(cropPrefab);
        crop.transform.SetParent(transform);
    }
}

0.3 生命周期对照

这是迁移时最重要的概念。两个引擎的游戏循环逻辑完全一致，只是方法名不同：

生命周期执行顺序图

完整生命周期代码对照

// === Cocos Creator ===
@ccclass('LifeDemo')
export class LifeDemo extends Component {
    onLoad()      { console.log('onLoad'); }
    onEnable()    { console.log('onEnable'); }
    start()       { console.log('start'); }
    update(dt)    { // dt = 帧间隔(秒)
        this.node.setPosition(this.node.position.x + 100 * dt, this.node.position.y);
    }
    lateUpdate()  {}
    onDisable()   { console.log('onDisable'); }
    onDestroy()   { console.log('onDestroy'); }
}

// === Unity (C#) ===
using UnityEngine;

public class LifeDemo : MonoBehaviour
{
    void Awake()     { Debug.Log("Awake"); }
    void OnEnable()   { Debug.Log("OnEnable"); }
    void Start()      { Debug.Log("Start"); }
    void Update()     {
        // Time.deltaTime 等价于 Cocos 的 dt
        transform.position += new Vector3(100f * Time.deltaTime, 0, 0);
    }
    void LateUpdate() {}
    void OnDisable()  { Debug.Log("OnDisable"); }
    void OnDestroy()  { Debug.Log("OnDestroy"); }
}

0.4 Prefab 对照

Prefab（预制体）概念完全相同：把配置好的对象保存为模板，运行时动态创建实例。

完整代码：动态生成农作物

// Cocos Creator
@property({ type: Prefab })
cropPrefab: Prefab = null;

spawnCrop(x, y) {
    let crop = instantiate(this.cropPrefab);
    crop.setPosition(new Vec3(x, y, 0));
    crop.setParent(this.node);
}

// Unity (C#)
public GameObject cropPrefab; // Inspector 拖拽

public void SpawnCrop(float x, float z) {
    GameObject crop = Instantiate(cropPrefab);
    crop.transform.position = new Vector3(x, 0f, z);
    crop.transform.SetParent(transform);
}

0.5 坐标系与变换对照

这是从 Cocos 2D → Unity 3D 迁移时最大的思维转变。

位置与旋转代码对照

// Cocos Creator
this.node.setPosition(new Vec3(100, 200, 0));
this.node.setRotationFromEuler(0, 0, 45);
this.node.setScale(new Vec3(2, 2, 1));

// Unity (C#)
transform.position = new Vector3(100f, 200f, 0f);
transform.localPosition = new Vector3(5f, 0f, 0f);
transform.rotation = Quaternion.Euler(0f, 45f, 0f);
transform.localScale = new Vector3(2f, 2f, 2f);

0.6 资源加载方式对照

// Cocos Creator
resources.load('textures/farm_bg/spriteFrame', SpriteFrame, (err, asset) => {
    if (err) return;
    this.node.getComponent(Sprite).spriteFrame = asset;
});

// Unity (C#)
Sprite bgSprite = Resources.Load<Sprite>("textures/farm_bg");
GetComponent<SpriteRenderer>().sprite = bgSprite;
// 注意：路径不含扩展名，不含 "Resources/" 前缀

0.7 输入系统对照

// Cocos Creator
input.on(Input.EventType.KEY_DOWN, (event: EventKeyboard) => {
    if (event.keyCode === 65) console.log('A pressed');
});
this.node.on(Node.EventType.TOUCH_START, (event) => {
    let pos = event.getLocation();
});

// Unity (C#)
void Update()
{
    if (Input.GetKeyDown(KeyCode.A))
        Debug.Log("A pressed");
    if (Input.GetKey(KeyCode.W))
        transform.Translate(Vector3.forward * 5f * Time.deltaTime);
    if (Input.GetMouseButtonDown(0))
    {
        Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
        if (Physics.Raycast(ray, out RaycastHit hit))
            Debug.Log($"Hit: {hit.collider.gameObject.name}");
    }
}

0.8 场景管理对照

// Cocos Creator
director.loadScene('farm', () => { console.log('加载完成'); });

// Unity (C#) — 异步加载+进度条
IEnumerator LoadSceneAsync()
{
    AsyncOperation op = SceneManager.LoadSceneAsync("Farm");
    op.allowSceneActivation = false;
    while (!op.isDone)
    {
        float progress = Mathf.Clamp01(op.progress / 0.9f);
        Debug.Log($"Loading: {progress * 100}%");
        if (op.progress >= 0.9f) op.allowSceneActivation = true;
        yield return null;
    }
}
DontDestroyOnLoad(gameObject); // 跨场景保留

0.9 迁移速查总表

这张表是你迁移过程中最常用的参考。建议收藏本页。