Unity ScriptableObject资源

ScriptableObject 是继承自UnityEngine.Object的数据对象。它不像MonoBehaviour那样挂在GameObject上，而是通常保存成项目中的.asset资源，再由场景、 Prefab 或其他资源引用。最常见的用途是武器定义、角色模板、关卡规则和物品目录。

它解决的是“许多实例需要同一份编辑期数据”的问题。若十个敌人的组件都内嵌同一组配置，Prefab实例会各自保存一份值；若组件引用同一个ScriptableObject资源，配置有一个明确来源，设计人员也能在Inspector中单独编辑它。这里的收益来自共享数据，不等于任何使用ScriptableObject的架构都会更快。

ScriptableObject也给数据一个Unity能识别的对象身份。它可以引用材质、音频、Prefab和其他ScriptableObject，并通过Unity的资源工作流参与序列化。普通C#对象更适合只在内存中存在的短期状态；外部JSON更适合需要在Unity之外生产或交换的数据。

把“定义”和“状态”分开是这项工具的核心边界。剑的名称、图标和基础伤害属于定义；某位玩家手里这把剑的耐久度属于状态。前者适合共享资源，后者通常属于组件、存档模型或专门创建的运行时副本。

一个ScriptableObject类只是类型声明。CreateAssetMenu把具体派生类型加入Assets/Create菜单；创建菜单项后，Unity才会生成可保存、可引用的资源实例。也可以用ScriptableObject.CreateInstance<T>()创建不绑定.asset文件的临时实例，或用Object.Instantiate克隆现有对象。

组件上的 序列化字段 保存的是对ScriptableObject资源的引用，不会把资源的所有字段内嵌复制到组件中。Unity加载引用后，两个字段若指向同一资源，读取到的是同一个对象。任何运行时写入也会立即被其他引用者看到。

下面的图把项目数据、加载后的对象和每个角色的运行时状态分开。虚线表示创建新状态，实线表示共享引用。

一次典型的数据流如下：

1. 编辑器创建资源，并把支持的字段写入项目数据。
2. 场景或Prefab在序列化字段中保存对该资源的引用。
3. 运行时加载资源，所有引用者读取同一份定义。
4. 每个使用方根据定义创建或初始化自己的可变状态。

资源、临时实例与普通对象

这三种载体的生命周期不同，不能只因为字段形状相似就互换。先确定谁创建它、谁保存它、谁销毁它，再决定类型。

CreateInstance<T>()创建的是新的ScriptableObject实例，不是磁盘资源。只有编辑器代码调用AssetDatabase.CreateAsset等API后，实例才会绑定到项目文件。AssetDatabase属于UnityEditor，不能混进Player运行时代码。

Instantiate(template)会返回模板的克隆。克隆根对象上的值可以独立修改，但其中指向其他UnityEngine.Object的字段仍表达对象引用，不能假定整个依赖图都变成私有副本。若只是要保存几个计数器，普通C#状态通常更简单。

序列化边界

Unity只保存它支持的字段。公开字段默认参与序列化，私有字段需要[SerializeField]；属性本身不会因为有公开getter就自动保存。[NonSerialized]字段可以放临时缓存，但它不会把资源自动变成安全的会话状态容器。

Unity 6.6新增了原生Dictionary<TKey, TValue>序列化。受支持的键和值类型可以放在带[SerializeField]的字典字段中，不再一律需要平行List包装器。不过，多维数组、交错数组和直接嵌套的集合仍不受支持；复杂图还需要包装类型或[SerializeReference]。

ScriptableObject资源保存的是开发期间制作的数据。在已部署的Player中，修改已加载对象不会把更改写回项目中的.asset文件，也不能代替存档系统。需要跨启动保留的数据，应转成明确的存档DTO，并写入应用可写位置。

下面四个示例依次展示共享定义、独立运行时状态、显式运行时克隆和稳定存档标识。它们需要Unity 6.6的编辑器、UnityEngine程序集和场景配置；本地环境没有这些工具，因此每个代码块都明确标记为未执行，输出栏不会伪造Console日志。

创建共享武器定义

WeaponDefinition只暴露读取接口。设计人员通过Assets/Create创建资源，再把同一个资源拖给多个Weapon组件。

私有序列化字段保留Inspector编辑能力，却不会无意间增加公开写入API。OnValidate只把资源修正到允许的伤害范围；它不是运行时输入验证器，也不应承担会话初始化。

两个Weapon若引用同一资源，就会读到相同名称与伤害。若关卡需要一把数值不同的武器，应创建另一个定义资源或建立明确的修饰规则，而不是在某个武器实例上偷偷改共享资源。

把当前生命值留给组件

ActorDefinition保存可共享的最大生命值，Actor保存每个GameObject自己的当前生命值。这个边界避免了两个敌人互相扣血。

// # not executed here: Unity Editor 6.6 and UnityEngine are unavailable.
using UnityEngine;

[CreateAssetMenu(fileName = "Actor", menuName = "Game/Actor Definition")]
public sealed class ActorDefinition : ScriptableObject
{
    [SerializeField, Min(1)] private int maxHealth = 100;

    public int MaxHealth => maxHealth;
}

public sealed class Actor : MonoBehaviour
{
    [SerializeField] private ActorDefinition definition;

    public int CurrentHealth { get; private set; }

    private void Awake()
    {
        if (definition == null)
        {
            Debug.LogError($"{name}: actor definition is missing.", this);
            enabled = false;
            return;
        }

        CurrentHealth = definition.MaxHealth;
    }

    public void TakeDamage(int amount)
    {
        if (amount <= 0 || !enabled)
            return;

        CurrentHealth = Mathf.Max(0, CurrentHealth - amount);
    }
}

# not executed here: Unity Editor 6.6 and UnityEngine are unavailable.

定义在Awake中只被读取。场景中的每个Actor都有独立的CurrentHealth，销毁GameObject时状态随拥有者结束。存档需要保留它时，应导出数值，而不是尝试修改ActorDefinition。

这个写法也让测试更直接：给两个实例同一份定义，伤害其中一个，然后断言另一个不变。只检查单个实例无法发现共享状态放错位置的问题。

必须传递Unity对象时克隆

有些现有API要求传入ScriptableObject。此时可以克隆模板，但要让一个明确的拥有者负责初始化和销毁副本。

// # not executed here: Unity Editor 6.6 and UnityEngine are unavailable.
using System;
using UnityEngine;

[CreateAssetMenu(fileName = "SessionRules", menuName = "Game/Session Rules")]
public sealed class SessionRules : ScriptableObject
{
    [SerializeField, Min(0)] private int retryLimit = 3;
    [NonSerialized] private int remainingRetries;

    public int RemainingRetries => remainingRetries;

    public void BeginSession() => remainingRetries = retryLimit;

    public bool TryUseRetry()
    {
        if (remainingRetries == 0)
            return false;

        remainingRetries--;
        return true;
    }
}

public sealed class SessionRulesOwner : MonoBehaviour
{
    [SerializeField] private SessionRules template;
    public SessionRules RuntimeRules { get; private set; }

    private void Awake()
    {
        if (template == null)
            throw new InvalidOperationException("Session rules template is missing.");

        RuntimeRules = Instantiate(template);
        RuntimeRules.BeginSession();
    }

    private void OnDestroy()
    {
        if (RuntimeRules != null)
            Destroy(RuntimeRules);
    }
}

# not executed here: Unity Editor 6.6 and UnityEngine are unavailable.

BeginSession显式初始化非序列化状态，因此正确性不依赖资源何时收到OnEnable。拥有者保存克隆引用，并在自身结束时销毁它；模板始终只读。

若调用方并不要求UnityEngine.Object，把remainingRetries放进普通会话对象会更轻。克隆是生命周期选择，不是看到可变字段后的默认动作。

用稳定ID重建存档引用

存档只保存项目定义的itemId和数量。加载时由目录把ID解析回资源引用，存档格式不会依赖某次运行的对象实例。

// # not executed here: Unity Editor 6.6 and UnityEngine are unavailable.
using System;
using System.Collections.Generic;
using UnityEngine;

[CreateAssetMenu(fileName = "Item", menuName = "Game/Item Definition")]
public sealed class ItemDefinition : ScriptableObject
{
    [SerializeField] private string stableId = "";
    [SerializeField] private string displayName = "Unnamed item";

    public string StableId => stableId;
    public string DisplayName => displayName;
}

[Serializable]
public sealed class InventoryRecord
{
    public string itemId = "";
    public int quantity;
}

[CreateAssetMenu(fileName = "ItemCatalog", menuName = "Game/Item Catalog")]
public sealed class ItemCatalog : ScriptableObject
{
    [SerializeField]
    private Dictionary<string, ItemDefinition> itemsById = new();

    public bool TryResolve(InventoryRecord record, out ItemDefinition item)
    {
        item = null;
        if (record == null || string.IsNullOrWhiteSpace(record.itemId))
            return false;

        return itemsById.TryGetValue(record.itemId, out item);
    }
}

# not executed here: Unity Editor 6.6 and UnityEngine are unavailable.

这里的字典写法针对Unity 6.6。项目仍要验证ID非空且唯一，并为已删除或重命名的ID定义迁移策略。加载失败应产生可诊断结果，不能静默换成任意物品。

不要把GetInstanceID()写进存档。它用于区分当前运行中的对象，不是项目承诺的持久标识；稳定ID必须由内容管线拥有，并在发布前检查重复。

修复方法： 先给每个字段标注“编辑期定义”或“运行时状态”。后者放进组件、普通C#状态对象或有明确拥有者的运行时克隆，并用两个共享同一定义的实例做隔离测试。

修复方法： 临时空实例使用ScriptableObject.CreateInstance<T>()，从模板复制使用Object.Instantiate，项目资源则由编辑器菜单或AssetDatabase创建。三条路径对应不同的保存和所有权语义。

修复方法： 把资源生成工具放进仅编辑器程序集或Editor目录。运行时存档使用应用可写目录和独立DTO，不把.asset当作玩家保存文件。

修复方法： 运行时把模板视为只读，并在测试前后对资源做快照或重新加载。临时状态使用显式BeginSession、ResetState和释放路径，不把OnEnable当作“每局恰好一次”。

修复方法： 把批量变化当作数据迁移。扫描现有资源，记录迁移版本，显示将要修改的对象，并在提交前检查YAML或Inspector差异。

修复方法： 对照目标Unity版本检查序列化规则。6.6支持带[SerializeField]的受支持字典字段，但多维数组、交错数组和直接嵌套集合仍需要改造，并应做保存后重新加载测试。

• Unity 6.6手册：ScriptableObject
• Unity 6.6 API：ScriptableObject.CreateInstance
• Unity 6.6 API：CreateAssetMenuAttribute
• Unity 6.6 API：Object.Instantiate
• Unity 6.6手册：脚本序列化规则
• Unity 6.6手册：Unity 6.6新功能