.NET MAUI白标化：如何基于构建配置切换Styles与Colors文件

方案1：MSBuild条件性ItemGroup替换（推荐） #

直接通过MSBuild的条件判断，为不同构建配置引入对应客户的样式文件，替代默认文件，无需复制或修改物理路径，稳定性最高。

1. 打开项目文件（.csproj），替换默认的Styles/Colors引用为带条件的ItemGroup：

<!-- 先移除默认样式文件的引用 -->
<ItemGroup>
  <Remove Include="Resources\Styles\Styles.xaml" />
  <Remove Include="Resources\Styles\Colors.xaml" />
</ItemGroup>

<!-- 按客户配置引入对应文件 -->
<ItemGroup Condition="'$(Configuration)' == 'ClientA'">
  <MauiXaml Include="Resources\Clients\ClientA\Styles.xaml" LogicalName="Resources/Styles/Styles.xaml" />
  <MauiXaml Include="Resources\Clients\ClientA\Colors.xaml" LogicalName="Resources/Styles/Colors.xaml" />
</ItemGroup>

<ItemGroup Condition="'$(Configuration)' == 'ClientB'">
  <MauiXaml Include="Resources\Clients\ClientB\Styles.xaml" LogicalName="Resources/Styles/Styles.xaml" />
  <MauiXaml Include="Resources\Clients\ClientB\Colors.xaml" LogicalName="Resources/Styles/Colors.xaml" />
</ItemGroup>

注意：LogicalName必须和项目原本引用的路径完全一致（用斜杠/而非反斜杠\），这样MAUI资源系统会将其识别为默认样式文件，完全替代原路径内容。

2. 确保每个客户的样式文件结构与默认文件一致（根节点为ResourceDictionary，包含相同的样式键），避免运行时找不到样式。

方案2：稳定化预构建/后构建脚本 #

如果坚持用文件复制方式，可通过以下方式解决不稳定和清理失败问题：

预构建脚本（复制客户文件） #

在项目属性的「生成事件」中设置预构建命令，用绝对路径避免歧义，先清理再复制：

:: 清理目标Styles目录
rmdir /s /q "$(ProjectDir)Resources\Styles"
mkdir "$(ProjectDir)Resources\Styles"

:: 根据配置复制对应客户文件
if "$(ConfigurationName)" == "ClientA" (
  copy "$(ProjectDir)Resources\Clients\ClientA\*.xaml" "$(ProjectDir)Resources\Styles\"
) else if "$(ConfigurationName)" == "ClientB" (
  copy "$(ProjectDir)Resources\Clients\ClientB\*.xaml" "$(ProjectDir)Resources\Styles\"
)

• 用$(ProjectDir)宏确保路径绝对，避免相对路径混乱
• 先清理再复制，彻底避免旧文件残留

后构建脚本（安全清理） #

之前清理脚本导致构建失败，是因为MAUI构建时会锁定Styles目录文件。可将清理逻辑绑定到MSBuild的Clean目标，而非后构建事件：
在.csproj中添加：

<Target Name="CleanClientStyles" AfterTargets="Clean">
  <RemoveDir Directories="$(ProjectDir)Resources\Styles" />
</Target>

这样只有执行Clean命令时才会清理Styles目录，不会干扰正常构建流程。

方案3：运行时动态加载资源字典（备选） #

如果编译时切换仍有问题，可在运行时根据构建配置动态加载客户资源：

public App()
{
    InitializeComponent();

    // 根据配置加载对应客户的资源字典
#if ClientA
    var clientStyles = new ResourceDictionary { Source = new Uri("Resources/Clients/ClientA/Styles.xaml", UriKind.Relative) };
    var clientColors = new ResourceDictionary { Source = new Uri("Resources/Clients/ClientA/Colors.xaml", UriKind.Relative) };
    Resources.MergedDictionaries.Add(clientStyles);
    Resources.MergedDictionaries.Add(clientColors);
#elif ClientB
    var clientStyles = new ResourceDictionary { Source = new Uri("Resources/Clients/ClientB/Styles.xaml", UriKind.Relative) };
    var clientColors = new ResourceDictionary { Source = new Uri("Resources/Clients/ClientB/Colors.xaml", UriKind.Relative) };
    Resources.MergedDictionaries.Add(clientStyles);
    Resources.MergedDictionaries.Add(clientColors);
#endif

    MainPage = new MainPage();
}

同时在.csproj中将客户样式文件设为嵌入资源：

<ItemGroup Condition="'$(Configuration)' == 'ClientA'">
  <EmbeddedResource Include="Resources\Clients\ClientA\*.xaml" />
</ItemGroup>
<ItemGroup Condition="'$(Configuration)' == 'ClientB'">
  <EmbeddedResource Include="Resources\Clients\ClientB\*.xaml" />
</ItemGroup>

此方案无需修改默认样式引用，但资源是运行时加载，会有轻微启动延迟。

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