编写UWP/WinUI XAML的ThemeDictionaries时，应选用哪类主题键？

我在UWP/WinUI XAML的ThemeDictionaries中看到了Light、Dark、Default和HighContrast这些不同的键，看起来有些冗余，应该选用哪些？

官方文档的推荐 #

微软官方文档明确建议使用Light、Dark和HighContrast这三个键：

除了"HighContrast"字典外，还需为"Light"和"Dark"分别指定主题字典。尽管可以创建以"Default"为键的ResourceDictionary，但更建议明确使用"Light"、"Dark"和"HighContrast"。

WinUI官方控件的实际用法 #

但查看WinUI官方控件（比如DropDownButton）的主题资源代码时，却使用了Default、Light和HighContrast：

<ResourceDictionary.ThemeDictionaries>
        <ResourceDictionary x:Key="Default">
            <StaticResource x:Key="DropDownButtonForegroundSecondary" ResourceKey="TextFillColorSecondaryBrush"/>
            <StaticResource x:Key="DropDownButtonForegroundSecondaryPointerOver" ResourceKey="TextFillColorTertiaryBrush"/>
            <StaticResource x:Key="DropDownButtonForegroundSecondaryPressed" ResourceKey="TextFillColorTertiaryBrush"/>
        </ResourceDictionary>

        <ResourceDictionary x:Key="Light">
            <StaticResource x:Key="DropDownButtonForegroundSecondary" ResourceKey="TextFillColorSecondaryBrush"/>
            <StaticResource x:Key="DropDownButtonForegroundSecondaryPointerOver" ResourceKey="TextFillColorTertiaryBrush"/>
            <StaticResource x:Key="DropDownButtonForegroundSecondaryPressed" ResourceKey="TextFillColorTertiaryBrush"/>
        </ResourceDictionary>

        <ResourceDictionary x:Key="HighContrast">
            <StaticResource x:Key="DropDownButtonForegroundSecondary" ResourceKey="SystemColorButtonTextColorBrush"/>
            <StaticResource x:Key="DropDownButtonForegroundSecondaryPointerOver" ResourceKey="SystemColorHighlightColorBrush"/>
            <StaticResource x:Key="DropDownButtonForegroundSecondaryPressed" ResourceKey="SystemColorHighlightColorBrush"/>
        </ResourceDictionary>
    </ResourceDictionary.ThemeDictionaries>

具体选择建议 #

1. 优先遵循官方规范（推荐） #

开发自定义控件或应用主题资源时，优先使用Light、Dark、HighContrast：

• 这是微软明确推行的标准写法，能保证主题切换逻辑的一致性，避免潜在的兼容问题
• 明确区分亮/暗主题，消除Default带来的歧义——Default的行为依赖系统默认主题设置，可能导致资源加载不符合预期

2. 理解Default的定位 #

Default本质是一个** fallback 资源字典**：当当前系统主题没有对应的明确字典（比如用户用了Dark主题，但你没定义Dark字典），框架会自动 fallback 到Default的资源。
WinUI控件中保留Default是出于历史兼容考虑，同时可以减少重复代码（比如上面例子中Default和Light资源完全一致，可作为Dark主题的 fallback），但这种写法在现代WinUI开发中已不推荐。

3. 特殊场景处理 #

• 如果需要兼容Win10早期版本的UWP应用，可以保留Default作为 fallback，但同时必须添加Light和Dark字典以适配新的主题系统
• 高对比度主题必须单独定义HighContrast字典，因为它的色彩逻辑和普通亮/暗主题差异极大，无法通过 fallback 覆盖

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