MAUI多SDK风格项目间如何正确共享ResourceDictionary

你遇到的编译通过但运行报资源找不到、IntelliSense无提示的问题，是MAUI跨程序集加载XAML资源的特殊规则导致的，和WPF的资源加载逻辑有差异，按下面步骤配置即可正常使用，配置一次后可支持任意多个项目复用。

修正共享资源项目（当前为Project2）的配置 #

这一步是最容易漏的，类库项目中的XAML资源默认不会生成跨程序集加载所需的元数据，必须手动调整生成规则：

• 打开Project2的项目文件（csproj），将Colors.xaml的生成配置从默认的Content改为MauiXaml，并启用XAML编译：

<ItemGroup>
  <MauiXaml Include="Resources\Colors.xaml">
    <Generator>MSBuild:Compile</Generator>
  </MauiXaml>
</ItemGroup>

• 确认Colors.xaml对应的代码后置文件Colors.xaml.cs存在，且为带无参构造的partial类，构造中必须调用InitializeComponent()，正确代码如下：

namespace Project2.Resources;

public partial class Colors : ResourceDictionary
{
    public Colors()
    {
        InitializeComponent();
    }
}

注意：作为共享资源的字典，不要注册到Project2自身的App.xaml合并资源列表中，否则跨项目加载时会出现重复初始化冲突。

修正引用项目（Project1/3/4等）的资源注册方式 #

MAUI当前版本不支持WPF风格的跨程序集Pack URI Source加载方式，必须用类实例化的方式引入共享字典，注意两点：

• 共享字典要放在合并资源列表的最靠前位置，避免本地资源加载时找不到依赖的共享Key
• 命名空间映射必须和共享项目中类的实际命名空间、程序集名完全一致，不要写错拼写
  正确的App.xaml配置示例：

<?xml version="1.0" encoding="utf-8" ?>
<Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:shared="clr-namespace:Project2.Resources;assembly=Project2"
             x:Class="Project1.App">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <!-- 共享资源放在最前面 -->
                <shared:Colors />
                <!-- 后续再添加项目本地资源、MAUI默认内置资源 -->
                <ResourceDictionary Source="Resources/Styles/Colors.xaml" />
                <ResourceDictionary Source="Resources/Styles/Styles.xaml" />
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

生效验证&常见问题处理 #

• 配置完成后必须先清理解决方案，删除所有项目的bin、obj目录后重新生成，否则旧的编译缓存会导致加载失败
• 重新生成后直接运行，{StaticResource TestColor}即可正常解析，不会抛出XamlParseException
• 如果IntelliSense暂时不识别资源Key，不影响正常运行，等XAML设计器完成缓存刷新（通常重新生成后等待数十秒，或重启VS）即可正常提示。

多项目复用优化建议 #

后续Project3、Project4等项目需要复用资源时，建议做如下优化避免重复维护：

• 单独创建一个专门放共享资源的类库项目（例如命名为App.Shared.Resources），把所有公共颜色、样式、控件模板、值转换器都放到这个类库中，和业务代码解耦
• 所有业务项目只需要引用这个共享类库，在自身App.xaml中按上述方式实例化需要的共享资源字典即可
• 不要用文件链接的方式把共享XAML加到各个业务项目中，这种方式会导致XAML编译重复生成类，后续更新资源时容易出现多项目版本不一致的问题。

踩坑提醒：如果共享资源字典内部又合并了其他字典，被依赖的字典也必须按上述规则配置MauiXaml生成项，且在共享字典的合并列表中用类实例化的方式引入，不能用相对路径的Source属性，否则跨项目加载时会找不到依赖资源。

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