如何通过.csproj在.NET MAUI Blazor Hybrid中排除指定Razor页面？

针对你遇到的路由歧义问题，以下是几种标准实现方法，能确保同路由的页面仅在对应构建配置中生效：

方案一：项目文件中彻底排除目标文件（含生成文件） #

之前的操作只移除了Razor源文件，但构建生成的.razor.g.cs和代码后置文件仍在参与编译，导致路由冲突。需要在.csproj中针对不同配置做完整移除：

比如要在Debug配置下排除生产页面，Release下排除开发页面，可添加如下配置：

<!-- Debug环境：移除生产专属页面 -->
<ItemGroup Condition="'$(Configuration)' == 'Debug'">
  <Compile Remove="Pages/ProdHome.razor" />
  <Compile Remove="Pages/ProdHome.razor.cs" />
  <EmbeddedResource Remove="Pages/ProdHome.razor" />
  <Content Remove="Pages/ProdHome.razor" />
  <!-- 清理生成的中间代码文件 -->
  <Compile Remove="obj/Debug/**/Pages/ProdHome.razor.g.cs" />
</ItemGroup>

<!-- Release环境：移除开发专属页面 -->
<ItemGroup Condition="'$(Configuration)' == 'Release'">
  <Compile Remove="Pages/DevHome.razor" />
  <Compile Remove="Pages/DevHome.razor.cs" />
  <EmbeddedResource Remove="Pages/DevHome.razor" />
  <Content Remove="Pages/DevHome.razor" />
  <Compile Remove="obj/Release/**/Pages/DevHome.razor.g.cs" />
</ItemGroup>

操作后记得右键项目→清理，再重新构建，确保缓存的生成文件被彻底清除。

方案二：用条件编译指令控制路由生效 #

这种方式无需修改项目文件，直接在Razor页面中通过编译符号控制路由属性，让同一路由仅在指定配置下生效：

开发页面Pages/DevHome.razor：

#if DEBUG
@page "/home"
#endif

<h1>开发环境首页</h1>

生产页面Pages/ProdHome.razor：

#if !DEBUG
@page "/home"
#endif

<h1>生产环境首页</h1>

这种方法简洁直接，能避免路由歧义，同时保留所有文件在项目中，方便切换配置调试。

方案三：动态控制Blazor路由注册 #

如果需要更灵活的组件加载逻辑，可以在Program.cs或App.razor中根据构建配置动态指定路由范围：

方式1：在App.razor中切换路由组件 #

@using Microsoft.AspNetCore.Components.Routing

#if DEBUG
<Router AppAssembly="@typeof(App).Assembly" />
@* 若开发页面单独在类库中，可添加AdditionalAssemblies *@
@* <Router AppAssembly="@typeof(App).Assembly" AdditionalAssemblies="new[] { typeof(DevComponents).Assembly }" /> *@
#else
<Router AppAssembly="@typeof(App).Assembly" />
@* <Router AppAssembly="@typeof(App).Assembly" AdditionalAssemblies="new[] { typeof(ProdComponents).Assembly }" /> *@
#endif

方式2：在Program.cs中动态注册组件 #

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

builder.Services.AddMauiBlazorWebView();
#if DEBUG
builder.Services.AddBlazorWebViewDeveloperTools();
// 注册开发环境专属服务或组件
#endif

var app = builder.Build();
app.Run();

这种方式适合将不同环境的页面拆分到独立类库，实现更清晰的代码隔离。

关键注意点 #

• 无论用哪种方案，必须保证当前构建配置下，同一路由只有一个页面声明，否则仍会触发路由歧义错误。
• 使用项目文件排除方案时，切换配置后一定要清理项目，避免残留的生成文件干扰编译。
• 条件编译方案适合快速实现简单的环境区分；项目文件排除方案适合需要彻底移除敏感代码（如开发调试逻辑）的生产构建场景。

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