Xamarin.Forms实现明暗主题触发空引用错误的解决方案

该空引用错误是Xamarin.Forms AppThemeBinding适配Shell场景的典型问题，触发点集中在三个位置：

• 项目使用的Xamarin.Forms版本低于5.0稳定版，该版本前AppThemeBinding在XAML编译阶段对Shell依赖资源的解析存在生成代码缺陷，会导致g.cs文件中资源引用变量未正确赋值
• 替换全局资源时删除了资源必备的x:Key标记，Shell初始化阶段按固定Key查找基础样式、颜色资源时返回null
• Shell相关属性直接在AppShell.xaml根节点用AppThemeBinding赋值，导致XAML编译器生成的初始化代码顺序错误，资源未加载完成就被调用

1 版本适配 #

将共享项目及所有平台原生项目的Xamarin.Forms NuGet包统一升级到5.0.0.2012及以上稳定版本，升级后先删除解决方案下所有项目的bin、obj文件夹，再执行清理-重新生成操作，排除旧版本编译缓存影响。

2 修正App.xaml资源字典写法 #

不要直接在资源字典中声明无Key的AppThemeBinding资源，所有主题资源必须显式指定x:Key，Shell全局属性统一放在全局隐式样式中赋值，参考正确写法：

<Application.Resources>
    <ResourceDictionary>
        <!-- 主题色资源 必须带x:Key -->
        <Color x:Key="PageBackgroundColor">
            <AppThemeBinding Light="White" Dark="#121212"/>
        </Color>
        <Color x:Key="PrimaryTextColor">
            <AppThemeBinding Light="#212121" Dark="#f5f5f5"/>
        </Color>
        <!-- Shell全局样式 必须放在其他自定义样式之前 -->
        <Style TargetType="Shell" ApplyToDerivedTypes="True">
            <Setter Property="Shell.BackgroundColor" Value="{AppThemeBinding Light=#f8f8f8, Dark=#1f1f1f}"/>
            <Setter Property="Shell.ForegroundColor" Value="{AppThemeBinding Light=#212121, Dark=#ffffff}"/>
            <Setter Property="Shell.TitleColor" Value="{AppThemeBinding Light=#212121, Dark=#ffffff}"/>
            <Setter Property="Shell.UnselectedColor" Value="{AppThemeBinding Light=#8a8a8a, Dark=#9a9a9a}"/>
        </Style>
        <!-- 其余原有全局样式、资源放在Shell样式之后，保持原有Key不变 -->
    </ResourceDictionary>
</Application.Resources>

禁止在AppShell.xaml根节点直接给Shell附加属性绑定AppThemeBinding，这类写法会绕过资源字典初始化流程，直接导致自动生成代码取到空引用。

3 编译缓存清理 #

如果修改XAML后错误依然存在，按以下顺序操作：

• 完全关闭Visual Studio
• 删除解决方案目录下所有项目的bin、obj子文件夹
• 重新打开解决方案，先执行「清理解决方案」，再执行「重新生成解决方案」后部署

4 兜底兼容方案 #

若上述操作后仍存在兼容性问题，可放弃XAML层的AppThemeBinding写法，改为代码端监听系统主题切换事件动态更新资源值，示例代码：

// App.xaml.cs构造函数中添加
Application.Current.RequestedThemeChanged += (sender, args) =>
{
    var resources = Application.Current.Resources;
    if (args.RequestedTheme == OSAppTheme.Dark)
    {
        resources["PageBackgroundColor"] = Color.FromHex("#121212");
        resources["PrimaryTextColor"] = Color.FromHex("#f5f5f5");
        // 补充其余暗色主题资源赋值
    }
    else
    {
        resources["PageBackgroundColor"] = Color.White;
        resources["PrimaryTextColor"] = Color.FromHex("#212121");
        // 补充其余亮色主题资源赋值
    }
};

该写法完全兼容Xamarin.Forms 4.8以上版本，不会触发XAML编译生成代码的空引用问题。

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