Unity 开发基础

是什么，为什么存在

Unity 是带有可视化编辑器的实时应用引擎。场景、资源导入、渲染、物理和平台构建由引擎负责，游戏规则通常用 C# 组件表达。你不需要自己搭建完整主循环，但必须按 Unity 的对象模型和回调时机组织代码。

GameObject（游戏对象） 是场景中的基本对象。角色、相机、灯光、碰撞体和空的组织节点都以 GameObject 出现。GameObject 主要承载名称、激活状态、标签、层级和组件；真正的功能来自挂在它上面的组件。

Unity 组件（Unity component） 是一块可组合功能。MeshRenderer 负责显示网格，Collider 参与碰撞检测，继承 MonoBehaviour 的脚本则提供项目自己的行为。一个对象可以组合多种组件，而不必继承出一棵「敌人、飞行敌人、会发光的飞行敌人」类层级。

每个 GameObject 都有且只有一个不可移除的 Transform。它记录位置、旋转、缩放与父子关系。理解 GameObject、组件和 Transform 之间的边界，是阅读 Inspector、编写脚本和定位场景问题的共同起点。

初次接触 Unity 时，你会在摆放场景对象、给对象挂脚本、配置 Prefab、响应碰撞或逐帧移动时遇到这些概念。协程、Addressables、对象池和 DOTS 都建立在这套基础模型之上，但它们各自有独立的设计问题，不属于本主题的入门范围。

工作原理

Unity 项目把可编辑内容放在 Assets/，把包依赖记录在 Packages/，把项目级设置放在 ProjectSettings/。Library/ 是导入结果与缓存，可以由 Unity 重建，不应当作手写源文件。Project 窗口显示资源，Hierarchy 显示当前场景中的 GameObject，两者不是同一棵树。

Scene 视图用于编辑世界，Game 视图显示活动相机的输出。选中资源或场景对象后，Inspector 显示其可编辑数据。Console 收集编译错误、警告与 Debug.Log 输出；脚本不能编译时，先处理第一条编译错误，因为后续错误常是连锁反应。

场景保存 GameObject 层级及其组件的序列化状态。Prefab 则把一棵可复用的 GameObject 层级保存为项目资源。进入播放模式后，运行时操作的是加载或实例化出来的对象；停止播放通常会丢弃播放期间对场景实例做的修改。

GameObject 与组件组合

GameObject 是组件的共同所有者。组件通过 gameObject 取得所属对象，通过 transform 取得该对象的 Transform。GetComponent<T>() 与 TryGetComponent<T>() 默认只检查同一个 GameObject；查找父级或子级要显式使用对应 API。

一个脚本依赖同对象上的另一组件时，可以用 [RequireComponent(typeof(...))] 表达最低配置要求。Unity 在添加该脚本时补上缺失依赖，但不会回头修复已经存在、后来才出现新依赖要求的旧实例。运行时仍要为可选引用和外部输入定义失败路径。

组件是否启用与 GameObject 是否活动是两层状态。Behaviour.enabled = false 会停止该行为接收常规更新回调，但不会让整个对象消失。gameObject.SetActive(false) 会让对象及其子层级在场景中变为非活动状态，子对象自己的 activeSelf 仍可能是 true。

标签适合表达少量稳定分类，层（layer）主要供渲染剔除与物理过滤等系统使用。不要把名称当作身份协议。场景中改名后，依赖 GameObject.Find("Player") 的代码会在运行时才暴露问题。

常见内置组件各自只负责一部分能力：

• Transform 保存空间关系，每个 GameObject 必有一个。
• MeshFilter 与 MeshRenderer 分别提供网格数据和绘制方式。
• Rigidbody 与 Collider 让对象参与 3D 物理模拟和碰撞检测。
• Camera 定义视图与输出，AudioSource 播放音频。
• MonoBehaviour 脚本把项目逻辑接入 Unity 的消息与序列化系统。

Transform 层级与坐标

transform.position 和 transform.rotation 表示世界坐标；localPosition 和 localRotation 表示相对父 Transform 的坐标。没有父级时，两组位置通常一致。一旦父级发生移动、旋转或缩放，同一个局部值会映射到新的世界结果。

父子关系表达空间依赖，也影响激活状态传播。武器挂在角色手部、UI 元素挂在 Canvas、粒子效果挂在命中点，都是合适的层级关系。若只是想整理 Hierarchy，却不希望对象继承父级变换，就不应随意建立父子关系。

重新设置父级时，要先决定保留世界姿态还是保留局部姿态。SetParent(parent, true) 尝试保持世界位置、旋转和缩放；SetParent(parent, false) 保留相对新父级的局部值。生成代码若省略这个设计选择，经常会让对象在换父级时突然跳动。

物理对象通常由 Rigidbody 驱动，不应同时在每帧直接改 Transform 与物理系统争夺位置。普通视觉运动要乘 Time.deltaTime，物理写入则按对应固定更新策略处理。更完整的时序与物理约束分别属于 game-loop 和物理主题。

MonoBehaviour、字段与回调

继承 MonoBehaviour 的类可以作为脚本组件挂到 GameObject。Unity 按约定调用 Awake、OnEnable、Start、Update 和 OnDisable 等消息；它们不是由你的代码直接组成的一条普通调用链。方法名或签名写错时，编译器未必能把它当作接口实现错误提示出来。

同一组件上，首次激活时通常先执行 Awake，再执行 OnEnable，随后在第一次帧更新前执行 Start。OnEnable 可以反复出现，Start 在该实例存活期间只在首次启用后调用一次。场景开始时处于非活动状态的 GameObject，会推迟 Awake，直到它被激活。

不要默认一个 GameObject 的 Awake 一定先于另一个 GameObject 的 Awake。当对象间存在初始化依赖时，应通过显式引导器、事件或 Script Execution Order 中经过说明的约束建立顺序。把「通常碰巧如此」当作契约，会让场景规模扩大后出现间歇性空引用。

序列化字段（serialized field） 把脚本数据交给 Unity 保存，并在 Inspector 中提供编辑入口。常见写法是 [SerializeField] private float speed = 3f;：字段保持私有，设计师仍能配置实例。公开字段应表示真实的代码 API，而不是只为了让 Inspector 看见。

序列化值属于场景或资源数据。一个组件已经保存过 speed = 3 后，把脚本初始值改成 5，不会自动覆盖现有实例中的 3。因此，排查「代码明明写了新默认值」时，应先查看 Inspector 与 Prefab override。

Prefab 资源与实例

Prefab（预制体） 是保存为资源的 GameObject 层级模板。敌人、拾取物、弹丸和重复 UI 行适合做成 Prefab，因为结构、组件和默认配置可以集中维护。Instantiate 创建的是实例，不是第二个 Prefab 资源。

Prefab 实例保持与资源的连接。修改 Prefab 资源后，未被实例 override 的属性会反映变化；实例自己的 override 会保留。Apply 把选定 override 写回资源，Revert 则让实例重新采用资源值，这两个操作的影响方向相反。

Prefab 也可以嵌套，并可创建 Variant。嵌套适合真正的所有权关系，Variant 适合少量稳定差异。若变体之间大部分结构不同，强行继承只会堆积难以追踪的 override，此时独立 Prefab 更清楚。

运行时修改实例不会改写项目中的 Prefab 资源。若数据需要跨运行保存，应使用明确的存档系统，而不是期待 Inspector 或 Prefab 自动记录播放状态。ScriptableObject 适合共享配置，但其生命周期和保存语义属于独立主题。

示例

下面四个示例构成一个小型硬币拾取系统：先让硬币旋转，再保存数量、处理触发器，最后从 Prefab 生成一组实例。它们依赖 Unity 运行时；本地工具链没有 Unity Editor，也没有 UnityEngine 程序集，因此按约定标记为未执行，没有伪造日志。

让一个组件只做一件事

SpinPickup 只负责视觉旋转。速度由 Inspector 配置，代码不需要知道硬币如何计分或销毁。

将脚本挂到硬币 Prefab 根对象后，Update 只改变所属 Transform。乘上 Time.deltaTime 后，degreesPerSecond 表示每秒角度，而不是每帧角度。DisallowMultipleComponent 避免同一对象误挂两份旋转脚本。

这段代码没有全局查找，也没有假定场景中存在某个管理器。它的依赖只有所属 GameObject 与 Transform，而这两项由组件模型保证。

用组件保存领域状态

CoinInventory 拥有硬币数量，并为修改提供窄接口。Inspector 不需要直接写入运行时计数，所以该属性没有序列化。

// # not executed here: Unity Editor 6.6 is not installed in the local toolchain.
using System;
using UnityEngine;

public sealed class CoinInventory : MonoBehaviour
{
    public int Count { get; private set; }

    public void Add(int amount)
    {
        if (amount <= 0)
            throw new ArgumentOutOfRangeException(nameof(amount));

        Count += amount;
        Debug.Log($"coins: {Count}");
    }
}

# not executed here: Unity Editor 6.6 is not installed in the local toolchain.

Count 对其他组件可读，但只能由 CoinInventory 修改。拒绝非正数让错误靠近入口暴露，而不是等 UI 显示出负数后再猜来源。

若数量需要保存到磁盘，应把持久化放在专门边界。把字段显示在 Inspector，并不等于它会自动成为玩家存档。

通过触发器组合组件

硬币组件拥有自己的价值与一次性领取状态。玩家组件只负责把触发器事件转交给硬币，不直接改写硬币内部字段。

// # not executed here: Unity Editor 6.6 is not installed in the local toolchain.
using UnityEngine;

[RequireComponent(typeof(Collider))]
public sealed class CoinPickup : MonoBehaviour
{
    [SerializeField, Min(1)]
    private int value = 1;

    private bool collected;

    private void Reset()
    {
        GetComponent<Collider>().isTrigger = true;
    }

    public bool TryCollect(CoinInventory inventory)
    {
        if (collected || inventory == null)
            return false;

        collected = true;
        inventory.Add(value);
        Debug.Log($"picked: {name}");
        Destroy(gameObject);
        return true;
    }
}

# not executed here: Unity Editor 6.6 is not installed in the local toolchain.

RequireComponent 保证添加脚本时对象至少有一个 Collider，Reset 则为新添加或手动重置的组件设置编辑器默认值。它们不会替代 Prefab 验证：旧资源仍可能保留不合要求的配置。

collected 在 Destroy 真正生效前挡住重复触发。若以后改用对象池，就需要在复用入口重置该状态；这正是池化对象额外承担的生命周期契约。

玩家侧通过同对象查找取得依赖。这个版本要求触发器 Collider 与 CoinPickup 位于同一个 GameObject，Prefab 结构应按这条契约搭建。

// # not executed here: Unity Editor 6.6 is not installed in the local toolchain.
using UnityEngine;

[RequireComponent(typeof(CoinInventory))]
public sealed class PlayerCollector : MonoBehaviour
{
    private CoinInventory inventory;

    private void Awake()
    {
        inventory = GetComponent<CoinInventory>();
    }

    private void OnTriggerEnter(Collider other)
    {
        if (other.TryGetComponent<CoinPickup>(out var pickup))
            pickup.TryCollect(inventory);
    }
}

# not executed here: Unity Editor 6.6 is not installed in the local toolchain.

如果 Collider 放在硬币子对象，就应把查找契约明确改成 GetComponentInParent<CoinPickup>()，并测试嵌套层级。不要同时尝试同对象、父级、子级和全场景查找来「确保能找到」，那会掩盖 Prefab 配置错误。

从 Prefab 创建实例

CoinSpawner 接收类型化的 Prefab 引用与父 Transform。生成后显式设置局部坐标，使位置数组相对 spawnRoot 表达。

// # not executed here: Unity Editor 6.6 is not installed in the local toolchain.
using UnityEngine;

public sealed class CoinSpawner : MonoBehaviour
{
    [SerializeField] private CoinPickup coinPrefab;
    [SerializeField] private Transform spawnRoot;
    [SerializeField] private Vector3[] localPositions =
    {
        new(-2f, 0.5f, 0f),
        new(0f, 0.5f, 0f),
        new(2f, 0.5f, 0f)
    };

    private void Start()
    {
        if (coinPrefab == null || spawnRoot == null)
        {
            Debug.LogError("CoinSpawner is not configured.", this);
            enabled = false;
            return;
        }

        foreach (var localPosition in localPositions)
        {
            var coin = Instantiate(coinPrefab, spawnRoot);
            coin.transform.SetLocalPositionAndRotation(
                localPosition,
                Quaternion.identity);
        }

        Debug.Log($"spawned: {localPositions.Length}");
    }
}

# not executed here: Unity Editor 6.6 is not installed in the local toolchain.

字段类型是 CoinPickup，所以 Inspector 只能接受含该组件的兼容对象。与字符串地址相比，直接引用还能让 Unity 在构建依赖关系时看到这个资源连接。

该组件在 Start 中验证跨对象依赖，并在配置缺失时停止自己。生成数量高或实例频繁复用时，再根据 Profiler 证据考虑对象池；三个启动实例不需要先引入池管理器。

陷阱

修复方法： 在 Inspector 中序列化稳定引用，或在 Awake 中缓存同对象组件。必须动态发现对象时，定义注册、注销与缺失对象策略，不要依赖每帧搜索兜底。

修复方法： 默认使用 [SerializeField] private。只有调用方确实需要读写时才公开属性或方法，并在入口维护范围、空值和状态转换规则。

修复方法： 必需的同对象依赖用 [RequireComponent] 表达，并在 Awake 验证；可选能力使用 TryGetComponent 分支。错误信息应指出缺少哪个组件以及哪个对象配置错误。

修复方法： 先确定是普通 Transform 运动还是 Rigidbody 运动，再选择更新阶段与 API。按秒的普通运动使用 Time.deltaTime，物理行为按固定时间步和 Rigidbody 契约实现。

修复方法： 检查局部开关时用 activeSelf，检查层级中的实际状态时用 activeInHierarchy。测试父级禁用、子级局部禁用与重新激活三条路径。

修复方法： 修改前确认 Inspector 顶部显示的是 Prefab 资源还是场景实例。需要推广的 override 明确 Apply，只属于当前实例的差异保留为 override，并在退出播放模式前记录需要迁回编辑数据的值。

延伸阅读

• Unity C# 参考：GameObject bindings
• Microsoft Learn：Unity 中的 GameObject 与 C# 脚本
• Microsoft Learn：Unity 初学者系列
• Microsoft Learn：Unity 性能建议
• Microsoft C# 指南：字段
• Microsoft C# 参考：通用特性