Unity WebGL构建报错 删using UnityEditor致Photon报错解决方法

问题背景 #

• 基于Unity开发的游戏项目在构建WebGL版本时抛出编译错误，初始报错信息如下：
  
• 尝试按照通用教程删除代码中using UnityEditor引用后，项目内Photon相关脚本抛出新的编译错误，次生报错信息如下：
  
• 核心诉求：无需删除using UnityEditor引用，顺利完成WebGL版本构建。

可行修复方案 #

方案1：用预编译宏隔离Editor相关代码（最推荐，完全不需要删除using UnityEditor引用） #

UnityEditor是Unity编辑器专属的程序集，所有WebGL、Windows、安卓等发布平台的运行时构建都不会包含这个程序集，只要把所有依赖UnityEditor的代码用Unity内置的UNITY_EDITOR宏包裹，构建时这部分代码就会自动被排除，不会触发编译错误。
操作步骤：

• 恢复之前删除的所有using UnityEditor引用
• 给所有using UnityEditor引用语句加上宏包裹，示例代码：

// 其他正常的运行时引用
using UnityEngine;
using Photon.Pun;

#if UNITY_EDITOR
// 编辑器专属引用，构建非编辑器平台时会自动忽略
using UnityEditor;
#endif

• 找到所有调用了UnityEditor下类、方法、特性的代码块，同样用#if UNITY_EDITOR和#endif包裹，示例：

public class GameManager : MonoBehaviourPunCallbacks
{
    private void Awake()
    {
        // 正常运行时逻辑，所有平台都会编译
        PhotonNetwork.ConnectUsingSettings();
    }

#if UNITY_EDITOR
    // 仅在编辑器下生效的功能，构建时不会被编译
    [MenuItem("工具/快速连接测试")]
    private static void QuickConnectTest()
    {
        EditorUtility.OpenFilePanel("选择配置文件", "", "json");
    }
#endif
}

说明：Photon官方插件本身已经对Editor相关代码做了宏适配，你之前删除using UnityEditor后出现Photon报错，本质是误删了Photon插件本身在宏保护范围内的Editor引用，恢复后按上述方法加宏即可解决。

方案2：通过目录规则隔离Editor代码（一劳永逸避免同类问题） #

Unity默认会对项目中名为Editor的特殊文件夹做编译隔离：所有放在Editor文件夹下的脚本，只会在Unity编辑器环境下编译，完全不会参与WebGL等发布平台的构建，不需要手动加宏也不会触发构建报错。
操作注意事项：

• Editor文件夹可以在Assets目录下任意层级创建，比如Assets/Plugins/Photon/Editor、Assets/MyTools/Editor都是合法路径
• 仅将编辑器专属的工具脚本、自定义Inspector代码放入Editor文件夹，不要把游戏运行时逻辑脚本放在该目录下，否则构建后会出现逻辑丢失问题
• 移动脚本文件后如果出现引用丢失，重新关联对应脚本即可。

方案3：Photon相关次生报错修复 #

如果完成上述操作后Photon依然存在编译错误，可以按以下步骤排查：

• 检查当前使用的Photon版本与Unity大版本是否兼容，版本不匹配是Photon跨平台构建报错的常见原因
• 在编辑器环境下打开Photon设置面板，重新运行一次配置向导，补全WebGL平台所需的网络配置参数
• 打开Player Settings切换到WebGL平台，将API兼容级别设置为.NET Standard 2.1，过低的API级别会导致Photon网络库编译失败。

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