Unity游戏中JSON文件可空字符串的保存与加载问题

首先得明确你遇到的CS0453错误的根源：Unity的内置序列化系统（包括JsonUtility）不支持直接序列化可空值类型（比如TimeSpan?）。Nullable<T>虽然是值类型，但Unity序列化器要求可序列化字段必须是非可空值类型或者可序列化的引用类型，所以当你把TimeSpan?标记为可序列化字段时，就会触发这个错误。

下面给你三种实用的解决方案，适配不同的项目场景：

方案1：用字符串字段中转（最轻量化，无需额外依赖） #

核心思路是用Unity支持序列化的string字段存储时间的字符串形式，对外暴露一个TimeSpan?属性来处理转换逻辑，未通关时字符串存null即可。

using UnityEngine;
using System;

[Serializable]
public class LevelTimeData
{
    // 仅用于序列化存储的字符串字段，Unity能正常序列化它
    [SerializeField] private string _personalBestString;
    [SerializeField] private string _levelName;

    // 对外提供的业务属性，处理TimeSpan和字符串的转换
    public TimeSpan? PersonalBest
    {
        get
        {
            // 字符串为空/Null时，返回null表示未通关
            if (string.IsNullOrEmpty(_personalBestString))
                return null;
            
            return TimeSpan.Parse(_personalBestString);
        }
        set
        {
            // 赋值时把TimeSpan转为字符串，null则存null
            _personalBestString = value?.ToString() ?? null;
        }
    }

    public string LevelName => _levelName;

    public LevelTimeData(string levelName)
    {
        _levelName = levelName;
        PersonalBest = null; // 初始状态设为未通关
    }
}

使用这个类时，直接操作PersonalBest属性即可：

• 通关时：data.PersonalBest = yourClearTime;
• 未通关时：data.PersonalBest = null;
  序列化/反序列化用Unity的JsonUtility完全没问题，不会再报CS0453。

方案2：自定义可序列化的TimeSpan包装类（更面向对象） #

如果希望更优雅地封装TimeSpan的可空逻辑，可以写一个自定义的可序列化引用类型（类）来包装TimeSpan，Unity支持序列化自定义的类类型。

using UnityEngine;
using System;

[Serializable]
public class SerializableTimeSpan
{
    [SerializeField] private long _ticks;
    [SerializeField] private bool _hasValue;

    public TimeSpan? Value
    {
        get => _hasValue ? new TimeSpan(_ticks) : null;
        set
        {
            if (value.HasValue)
            {
                _ticks = value.Value.Ticks;
                _hasValue = true;
            }
            else
            {
                _ticks = 0;
                _hasValue = false;
            }
        }
    }

    // 隐式转换，让包装类可以直接和TimeSpan?互相转换，使用更方便
    public static implicit operator TimeSpan?(SerializableTimeSpan wrapper)
    {
        return wrapper?.Value;
    }

    public static implicit operator SerializableTimeSpan(TimeSpan? timeSpan)
    {
        return new SerializableTimeSpan { Value = timeSpan };
    }
}

然后在你的关卡数据类里使用这个包装类：

[Serializable]
public class LevelTimeData
{
    [SerializeField] private SerializableTimeSpan _personalBest;
    [SerializeField] private string _levelName;

    public TimeSpan? PersonalBest
    {
        get => _personalBest;
        set => _personalBest = value;
    }

    public string LevelName => _levelName;

    public LevelTimeData(string levelName)
    {
        _levelName = levelName;
        PersonalBest = null;
    }
}

这个方案的优势是把可空TimeSpan的逻辑封装在独立类里，代码结构更清晰，适合大型项目复用。

方案3：使用Newtonsoft.Json（功能最强大，需导入第三方库） #

如果你的项目已经导入了Newtonsoft.Json（很多Unity开发者会用它替代JsonUtility，因为支持更多序列化场景），那可以直接使用TimeSpan?，无需额外处理——Newtonsoft原生支持可空值类型的序列化和反序列化。

首先确保你已经安装了Newtonsoft.Json（可以通过Unity Package Manager搜索安装，或者手动导入dll），然后定义你的数据类：

using System;

// 不需要[Serializable]标记，Newtonsoft自己处理序列化
public class LevelTimeData
{
    public TimeSpan? PersonalBest { get; set; }
    public string LevelName { get; set; }

    public LevelTimeData(string levelName)
    {
        LevelName = levelName;
        PersonalBest = null;
    }
}

序列化和反序列化代码：

// 序列化到JSON字符串
var levelData = new LevelTimeData("ForestLevel");
string json = Newtonsoft.Json.JsonConvert.SerializeObject(levelData);

// 从JSON字符串反序列化
string savedJson = // 从文件读取的JSON内容
var loadedData = Newtonsoft.Json.JsonConvert.DeserializeObject<LevelTimeData>(savedJson);

这个方案最省心，但需要依赖第三方库，适合对序列化功能有更高要求的项目。

内容的提问来源于stack exchange，提问作者Question3r