Unity项目构建报错：AnimatorController无法识别，如何解决？

问题根源 #

UnityEditor.Animations命名空间下的AnimatorController是编辑器专属类型，Unity构建项目时不会包含Editor程序集，因此直接引用或用#if UNITY_EDITOR包裹都会导致运行时找不到该类型。而游戏运行时无需直接依赖编辑器专属类型，可通过UnityEngine中的通用基类替代。

具体修复步骤 #

• 替换类型引用：将代码中所有AnimatorController替换为RuntimeAnimatorController，该类型属于UnityEngine命名空间，编辑器和运行时均支持，且所有动画控制器（包括AnimatorController）都继承自它，Inspector面板依然可以正常赋值。
• 调整using语句：移除带条件编译的using UnityEditor.Animations;，确保代码引用using UnityEngine;（若未添加则补充）。
• 隔离编辑器专属逻辑：如果确实需要在编辑器中操作AnimatorController的专属功能（如修改图层、参数），将这部分代码用#if UNITY_EDITOR包裹，并通过类型转换将RuntimeAnimatorController转为UnityEditor.Animations.AnimatorController后再操作。

代码示例 #

修改前（报错代码） #

#if UNITY_EDITOR
using UnityEditor.Animations;
#endif
using UnityEngine;

public class Freddy : MonoBehaviour
{
    public AnimatorController animatorController;
    private Animator _animator;

    void Start()
    {
        _animator = GetComponent<Animator>();
        _animator.runtimeAnimatorController = animatorController;
    }
}

修改后（可正常构建） #

using UnityEngine;

public class Freddy : MonoBehaviour
{
    public RuntimeAnimatorController animatorController;
    private Animator _animator;

    void Start()
    {
        _animator = GetComponent<Animator>();
        _animator.runtimeAnimatorController = animatorController;
    }

    // 编辑器专属逻辑示例（仅在Unity编辑器中执行）
    void OnValidate()
    {
        #if UNITY_EDITOR
        var editorController = animatorController as UnityEditor.Animations.AnimatorController;
        if (editorController != null)
        {
            // 执行仅编辑器支持的操作，例如检查控制器图层数量
            Debug.Log($"AnimatorController layer count: {editorController.layers.Length}");
        }
        #endif
    }
}

验证构建 #

修改完成后，清理项目缓存（Assets -> Clear Cache），再尝试构建项目即可解决编译错误，同时游戏仍可正常使用AnimatorController驱动动画。

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