ASP.NET Web应用迁移到Mac Rider时System.Web.UI报错如何解决

根因说明 #

System.Web.UI是ASP.NET Web Forms的专属API，Web Forms是仅面向Windows系统的.NET Framework内置技术栈，没有官方跨平台实现，也不存在单独可下载的跨平台System.Web.UI依赖包，Mac原生环境无法直接支持该技术栈的项目，这是你遇到报错的核心原因。

可选解决方案 #

• 方案1：迁移到跨平台ASP.NET Core技术栈（长期推荐） #

  这是微软官方给出的Web Forms替代方案，完全支持Mac环境运行：
  1. 在Rider中新建ASP.NET Core项目，可根据原有项目业务场景选择Blazor Server或者Razor Pages模板，二者都可以覆盖Web Forms的开发场景
  2. 迁移原有项目中不依赖System.Web的业务逻辑代码，大部分通用C#代码可以直接复用
  3. 将原有.aspx页面、服务器控件逻辑重写为Razor语法的页面/组件，原System.Web.UI的相关API对应替换为ASP.NET Core的内置实现
  4. 用appsettings.json+中间件配置替代原有Web.config的相关配置

• 方案2：Windows虚拟机运行（无需修改代码，短期应急） #

  不需要调整原有代码，直接在Mac上安装虚拟机软件，创建Windows虚拟机后在虚拟机内安装Visual Studio运行原有Web Forms项目即可，适合不需要长期在Mac上迭代开发的场景。

• 方案3：基于Mono兼容运行（兼容度有限） #

  Mono是社区维护的.NET Framework跨平台开源实现，对System.Web有基础兼容：
  1. 先在Mac上安装最新版Mono运行时
  2. 在Rider的项目属性设置中，将目标运行时切换为已安装的Mono版本
  3. 该方案仅支持基础的Web Forms功能，复杂控件、Windows专属API、第三方依赖大概率会出现兼容问题，仅适合非常简单的测试类项目使用

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