Unity UI显示初始值最佳实践：跨场景持久化对象事件同步问题

方案一：订阅事件时主动拉取初始值 #

在UI组件初始化（或启用）时，完成事件订阅后主动调用Player的状态查询接口，同步初始值。这种方式逻辑直接，无需修改事件系统核心逻辑。

Player类补充代码 #

public class Player : MonoBehaviour
{
    public event Action<int, int> OnHPChanged;
    private int _currentHP;
    private int _maxHP;

    void Start()
    {
        _maxHP = 100;
        _currentHP = _maxHP;
    }

    // 提供外部查询当前HP状态的接口
    public void GetCurrentHPState(out int currentHP, out int maxHP)
    {
        currentHP = _currentHP;
        maxHP = _maxHP;
    }

    // 封装maxHP变更逻辑，确保变更时触发事件
    private void SetMaxHP(int value)
    {
        if (_maxHP == value) return;
        
        _maxHP = value;
        OnHPChanged?.Invoke(_currentHP, _maxHP);
    }
}

UI类修改代码 #

public class PlayerUI : MonoBehaviour
{
    [SerializeField] private TextMeshProUGUI playerHPText;
    private Player _player;

    void Awake()
    {
        // 找到跨场景持久化的Player实例
        _player = FindObjectOfType<Player>();
    }

    void OnEnable()
    {
        // 订阅HP变更事件
        _player.OnHPChanged += UpdatePlayerHP;
        // 主动拉取初始值并更新UI
        _player.GetCurrentHPState(out int currentHP, out int maxHP);
        UpdatePlayerHP(currentHP, maxHP);
    }

    void OnDisable()
    {
        // 取消订阅，避免内存泄漏
        _player.OnHPChanged -= UpdatePlayerHP;
    }

    private void UpdatePlayerHP(int currentHP, int maxHP)
    {
        playerHPText.text = maxHP.ToString();
    }
}

方案二：扩展事件系统，订阅时自动触发初始值 #

修改Player的事件注册逻辑，在新订阅者加入时，自动将当前状态推送给订阅者。这种方式让UI组件无需额外调用，仅需完成订阅即可同步最新值。

Player类修改代码 #

public class Player : MonoBehaviour
{
    private Action<int, int> _onHPChanged;
    private int _currentHP;
    private int _maxHP;

    // 自定义事件的add/remove逻辑
    public event Action<int, int> OnHPChanged
    {
        add
        {
            _onHPChanged += value;
            // 订阅时立即推送给新订阅者当前状态
            value?.Invoke(_currentHP, _maxHP);
        }
        remove
        {
            _onHPChanged -= value;
        }
    }

    void Start()
    {
        _maxHP = 100;
        _currentHP = _maxHP;
    }

    private void SetMaxHP(int value)
    {
        if (_maxHP == value) return;
        
        _maxHP = value;
        _onHPChanged?.Invoke(_currentHP, _maxHP);
    }
}

UI类简化代码 #

public class PlayerUI : MonoBehaviour
{
    [SerializeField] private TextMeshProUGUI playerHPText;
    private Player _player;

    void Awake()
    {
        _player = FindObjectOfType<Player>();
    }

    void OnEnable()
    {
        _player.OnHPChanged += UpdatePlayerHP;
    }

    void OnDisable()
    {
        _player.OnHPChanged -= UpdatePlayerHP;
    }

    private void UpdatePlayerHP(int currentHP, int maxHP)
    {
        playerHPText.text = maxHP.ToString();
    }
}

方案三：用ScriptableObject做全局数据容器 #

将Player的状态数据存储在ScriptableObject中，这种方式完全解耦数据与逻辑，跨场景时数据自动保留，UI可直接监听数据变更或读取初始值。

创建PlayerData ScriptableObject #

[CreateAssetMenu(fileName = "PlayerData", menuName = "Game/Player Data")]
public class PlayerDataSO : ScriptableObject
{
    public event Action<int, int> OnHPChanged;

    [SerializeField] private int _maxHP = 100;
    [SerializeField] private int _currentHP = 100;

    public int MaxHP => _maxHP;
    public int CurrentHP => _currentHP;

    public void SetMaxHP(int value)
    {
        if (_maxHP == value) return;
        
        _maxHP = value;
        OnHPChanged?.Invoke(_currentHP, _maxHP);
    }
}

Player类引用数据容器 #

public class Player : MonoBehaviour
{
    [SerializeField] private PlayerDataSO _playerData;

    void Start()
    {
        // 初始化数据（若需要）
        _playerData.SetMaxHP(100);
    }
}

UI类对接数据容器 #

public class PlayerUI : MonoBehaviour
{
    [SerializeField] private TextMeshProUGUI playerHPText;
    [SerializeField] private PlayerDataSO _playerData;

    void OnEnable()
    {
        _playerData.OnHPChanged += UpdatePlayerHP;
        // 初始化读取一次值
        UpdatePlayerHP(_playerData.CurrentHP, _playerData.MaxHP);
    }

    void OnDisable()
    {
        _playerData.OnHPChanged -= UpdatePlayerHP;
    }

    private void UpdatePlayerHP(int currentHP, int maxHP)
    {
        playerHPText.text = maxHP.ToString();
    }
}

Unity最佳实践建议 #

• 事件订阅规范：始终在OnEnable中订阅事件，OnDisable中取消订阅，避免重复订阅和内存泄漏。
• 单例与持久化：跨场景持久化对象使用单例模式时，需确保实例唯一（如在Awake中判断并销毁重复实例），配合DontDestroyOnLoad使用。
• 数据解耦：优先用ScriptableObject存储全局共享数据，便于调试、修改，且无需依赖特定GameObject实例。
• 数据封装：所有状态变更必须通过封装方法完成，禁止直接修改字段，确保每次变更都能触发事件通知。
• 状态缓存：事件系统中缓存最新状态，确保新订阅者能立即获取当前值，避免初始同步遗漏。

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