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#参考：通用特性