Unity项目构建遇UnityEditor命名空间插件报错的最佳解决方法

核心问题分析 #

直接用#if UNITY_EDITOR包裹using UnityEditor;后错误变多，本质是只处理了引用声明，代码中直接调用UnityEditor命名空间下的类型、方法、属性的部分没做条件编译包裹——构建时这些代码依然会被编译，自然报错。

分步解决方案 #

1. 全面包裹Editor相关代码 #

不仅要包裹using UnityEditor;，所有依赖UnityEditor的代码块、类型、方法、属性都要放在#if UNITY_EDITOR和#endif之间。示例：

#if UNITY_EDITOR
using UnityEditor;
#endif

public class PluginCore : MonoBehaviour
{
    // 运行时正常逻辑，无需包裹
    void Update()
    {
        Debug.Log("Runtime code");
    }

#if UNITY_EDITOR
    // Editor专属方法，必须包裹
    [MenuItem("Plugin/Editor Only Action")]
    public static void DoEditorTask()
    {
        Selection.activeTransform = null;
    }

    // 依赖Editor类型的字段
    private EditorWindow _customEditorWindow;
#endif
}

2. 用程序集定义分离Editor与运行时代码 #

既然插件是独立程序集，创建两个.asmdef文件拆分代码：

• 主程序集（如PluginRuntime.asmdef）：只放运行时代码，程序集设置里不引用UnityEditor，「Include Platforms」勾选所有非Editor平台。
• Editor程序集（如PluginEditor.asmdef）：专门放所有依赖UnityEditor的代码，程序集设置里引用主程序集和UnityEditor，「Include Platforms」只勾选「Editor」。

注：Editor程序集的文件夹无需强制命名为Editor，靠asmdef的平台设置控制即可。

3. 处理间接依赖问题 #

如果插件存在未覆盖的间接引用（比如方法返回Editor类型、参数是Editor类型），需：

• 把这类方法整体用条件编译包裹，仅在Editor环境可见
• 或拆分逻辑：将Editor相关代码抽离到Editor程序集的类中，主程序集只保留运行时可用的部分

4. 批量处理小技巧 #

插件文件较多时，用Unity全局查找替换批量操作：

• 先把using UnityEditor;替换为#if UNITY_EDITOR\nusing UnityEditor;\n#endif
• 再全局搜索UnityEditor.，逐一检查这些引用的代码是否都被条件编译包裹

常见坑点 #

• 不要漏了[MenuItem]、[CustomEditor]这类Editor专属属性，必须放在条件编译块内
• 程序集引用要单向：Editor程序集依赖主程序集，主程序集不能依赖Editor程序集
• 若插件有第三方依赖，要确认依赖本身是否做了正确的Editor代码分离

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