基于ASP.NET Core的Blazor WASM如何按环境完全排除页面？

当然可以实现完全排除，下面是几个实用的方案，从构建到运行层面覆盖不同场景：

1. MSBuild条件编译：从构建阶段彻底排除文件 #

这是最彻底的方式——直接让指定环境的构建过程忽略调试页面文件，不会把它们打包到最终的WASM bundle里。

打开你的Blazor WASM项目文件（.csproj），添加类似配置：

<ItemGroup>
  <!-- 仅在Debug或QA环境下包含调试页面及样式文件 -->
  <Compile Include="Pages/Debug/**/*.razor" Condition="'$(Configuration)' == 'Debug' Or '$(Configuration)' == 'QA'" />
  <EmbeddedResource Include="Pages/Debug/**/*.razor.css" Condition="'$(Configuration)' == 'Debug' Or '$(Configuration)' == 'QA'" />
</ItemGroup>

也可以反过来配置，在Release环境下主动排除：

<ItemGroup>
  <!-- Release环境下移除调试页面相关文件 -->
  <Compile Remove="Pages/Debug/**/*.razor" Condition="'$(Configuration)' == 'Release'" />
  <EmbeddedResource Remove="Pages/Debug/**/*.razor.css" Condition="'$(Configuration)' == 'Release'" />
</ItemGroup>

这样Release构建时，这些页面文件根本不会被编译和打包，彻底从应用中消失。

2. 条件注册路由组件 #

如果调试页面是路由访问的Razor组件，可以在Program.cs里根据环境条件决定是否注册该路由，同时确保组件没有被其他代码引用（编译器会自动树摇掉未被引用的组件）。

示例代码：

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("#app");
builder.RootComponents.Add<HeadOutlet>("head::after");

// 仅在Dev或QA环境注册调试页面路由
if (builder.HostEnvironment.IsDevelopment() || builder.HostEnvironment.EnvironmentName == "QA")
{
    builder.RootComponents.Add<DebugDashboard>("/debug-dashboard");
}

// 其他服务注册逻辑...

await builder.Build().RunAsync();

只要调试组件没有被其他代码引用，Release环境下编译器会把它从最终bundle中移除，同时路由也不会存在，完全无法访问。

3. 预编译指令移除组件代码 #

如果不想整个文件排除，也可以在调试页面组件内部用C#预编译指令，让指定环境下的代码完全不被编译：

@* 仅在DEBUG或QA环境下编译该组件 *@
#if DEBUG || QA
@page "/debug-tools"
@inject IWebAssemblyHostEnvironment hostEnvironment

<h3>调试工具页面</h3>
<!-- 页面内容 -->
#endif

需要先在项目文件里为QA环境添加自定义编译符号：

<PropertyGroup Condition="'$(Configuration)' == 'QA'">
  <DefineConstants>DEBUG;QA</DefineConstants>
</PropertyGroup>

这样非DEBUG/QA环境下，这个组件的代码会被完全忽略，编译后相当于空文件，不会被打包到应用中。

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