WinUI 3/UWP自定义控件库创建指南：资源字典与样式该如何正确引入？

Generic.xaml 与 App.xaml 存放资源的差异 #

两者的作用域和定位完全不同，分开存放是框架本身的原生约定：

• Themes/Generic.xaml是自定义控件库的默认主题资源字典，属于控件侧的约定存放路径：所有自定义控件的默认隐式样式、控件模板、仅控件内部使用的私有资源，都应该放在这里。系统渲染自定义控件时，会自动从这个路径查找默认样式，不需要使用者手动引入，是保证控件自包含的核心位置。你观察到的PowerToys放在这里的资源，都是Settings.UI这个控件库专属的控件样式、内部依赖资源。
• App.xaml是应用级的全局资源入口，这里存放的是供整个应用所有页面、组件共用的公共资源：比如全局颜色变量、通用样式、跨页面复用的转换器、数据模板等，作用域覆盖整个应用进程，合并后所有位置都可以直接调用。PowerToys放在这里的资源，就是给整个设置应用的所有页面共用的公共资源。

同一资源同时在两个文件引入的原因 #

你提到的IsEnabledTextBlock资源字典重复引入的设计，本质是兼顾两个需求，且不会产生性能冗余：

1. 在Generic.xaml中引入，是为了保证控件库的自包含性：哪怕使用者没有在自己的应用App.xaml中合并这个资源，自定义控件本身在设计器、运行时都能正常找到依赖的资源，不会出现样式丢失、渲染报错的问题，控件单独分发使用也能正常工作。
2. 在App.xaml中再次引入，是为了让应用层面的其他页面、非自定义控件的组件也能直接使用这个资源，不需要重复定义。且XAML的资源字典有内置去重机制，同一个资源字典多次引入只会加载一次，不会产生额外的性能开销。

通用自定义控件库的资源引入规范 #

开发可分发的通用控件库时，遵循以下规则即可：

• 所有自定义控件的默认隐式样式（无x:Key、TargetType指向自定义控件的样式）、控件专属模板、仅控件内部使用的资源，统一放在Themes/Generic.xaml下编写或合并，严格遵循框架原生约定。
• 供使用者全局复用的公共资源（比如通用设计Token、公共样式、通用转换器），单独抽成独立的资源字典文件，在库的使用文档中告知使用者可按需在自身的App.xaml中合并引入。
• 如果你的自定义控件依赖了非默认的公共资源，必须在Generic.xaml中先合并一次对应的资源字典，避免使用者漏引资源导致控件渲染异常。
• 主题专属资源（比如浅色/深色模式对应的颜色、画笔）可以单独存放在Themes/Light.xaml、Themes/Dark.xaml等文件中，系统会自动根据当前系统主题加载对应资源，不需要手动切换。

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