Unity UI Toolkit运行时数据绑定：求非依赖Unity Editor的BindProperty替代方案

问题概述 #

• 因熟悉CSS且设计效率更高，选择UI Toolkit替代Unity旧UI系统，但该系统目前偏向编辑器GUI方向。
• 核心需求：实现UI与数据类变量的绑定，抽象更新逻辑，未来需适配多人RTS场景。
• 当前困境：使用SerializedObject的绑定方案在编辑器中正常运行，但打包时因依赖UnityEditor报错；官方教程模糊，手动实现的Update轮询和委托方案难以抉择。

可行替代方案 #

方案1：基于事件/委托的轻量绑定（推荐） #

该方案仅在数值变更时更新UI，性能高效，适合RTS频繁数值变化的场景，且完全不依赖UnityEditor。

1. 改造数据类，添加变更事件

using UnityEngine;
using System;

public class PlayerResources : MonoBehaviour
{
    private int _food;
    // 定义数值变更事件
    public event Action<int> OnFoodChanged;

    public int Food
    {
        get => _food;
        set
        {
            if (_food != value)
            {
                _food = value;
                // 触发事件通知UI更新
                OnFoodChanged?.Invoke(value);
            }
        }
    }
}

2. UI绑定逻辑

using UnityEngine;
using UnityEngine.UIElements;

[RequireComponent(typeof(UIDocument))]
public class ResourceUIBinder : MonoBehaviour
{
    public PlayerResources playerResources;
    private UIDocument _uiDocument;
    private Label _foodLabel;

    void Awake()
    {
        _uiDocument = GetComponent<UIDocument>();
        _foodLabel = _uiDocument.rootVisualElement.Q<Label>("FoodVar");
        
        if (playerResources != null)
        {
            // 初始化UI显示
            _foodLabel.text = playerResources.Food.ToString();
            // 订阅数值变更事件
            playerResources.OnFoodChanged += UpdateFoodUI;
        }
    }

    void OnDestroy()
    {
        // 取消订阅，避免内存泄漏
        if (playerResources != null)
        {
            playerResources.OnFoodChanged -= UpdateFoodUI;
        }
    }

    private void UpdateFoodUI(int newValue)
    {
        _foodLabel.text = newValue.ToString();
    }
}

方案2：使用UnityEvent可视化绑定 #

若偏好可视化操作，可改用UnityEvent替代C#原生委托，无需手动编写订阅代码：

1. 数据类改造

using UnityEngine;
using UnityEngine.Events;

public class PlayerResources : MonoBehaviour
{
    private int _food;
    // 可视化事件，可在Inspector中直接绑定
    public UnityEvent<int> OnFoodChanged;

    public int Food
    {
        get => _food;
        set
        {
            if (_food != value)
            {
                _food = value;
                OnFoodChanged?.Invoke(value);
            }
        }
    }
}

2. UI更新脚本

using UnityEngine;
using UnityEngine.UIElements;

public class ResourceUIUpdater : MonoBehaviour
{
    private UIDocument _uiDocument;
    private Label _foodLabel;

    void Awake()
    {
        _uiDocument = GetComponent<UIDocument>();
        _foodLabel = _uiDocument.rootVisualElement.Q<Label>("FoodVar");
    }

    // 在Inspector中绑定到PlayerResources的OnFoodChanged事件
    public void UpdateFoodUI(int newValue)
    {
        _foodLabel.text = newValue.ToString();
    }
}

方案3：UI Toolkit官方运行时绑定（需高版本支持） #

Unity 2022.2及以上版本的UI Toolkit支持基于INotifyPropertyChanged的运行时绑定，无需依赖UnityEditor：

1. 数据类实现INotifyPropertyChanged

using UnityEngine;
using System.ComponentModel;

public class PlayerResources : MonoBehaviour, INotifyPropertyChanged
{
    private int _food;

    public event PropertyChangedEventHandler PropertyChanged;

    public int Food
    {
        get => _food;
        set
        {
            if (_food != value)
            {
                _food = value;
                OnPropertyChanged(nameof(Food));
            }
        }
    }

    private void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

2. UI绑定设置

• 在UI Builder中选中目标Label，在Binding面板设置Binding Path为Food
• 代码中绑定数据对象：

UIDocument docum = trackCanvas.GetComponent<UIDocument>();
if(playerResources != null)
{
    docum.rootVisualElement.Bind(playerResources);
}
else
{
    docum.rootVisualElement.Unbind();
}

注意：该功能需要Unity版本≥2022.2，且需确保UI元素的绑定路径与数据类属性名完全匹配。

方案对比 #

• 方案1：性能最优，代码可控，适合复杂逻辑和多人场景扩展。
• 方案2：可视化操作，适合快速原型开发、逻辑简单的场景。
• 方案3：官方原生绑定，代码简洁，但依赖较新Unity版本，灵活性稍差。

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