DynamicResource 支持运行时动态更新，适用于主题切换、多语言等场景；StaticResource 仅在加载时解析一次，性能高但不响应变更。资源字典必须通过 MergedDictionaries 显式合并，否则 DynamicResource 无法查找。
Avalonia 中的 DynamicResource 和 StaticResource 是两种资源引用方式，核心区别在于**何时解析、是否响应变更**。选错会影响主题切换、多语言更新等关键功能。
DynamicResource：支持运行时动态更新
适用于需要随主题、语言或配置变化而自动刷新的资源，比如颜色、字体大小、翻译文本等。
- 在控件渲染或属性变更时实时查找资源，每次访问都重新解析
- 资源可定义在任意层级（App、Window、UserControl 或独立 ResourceDictionary），只要在查找路径中能被找到
- 必须配合
MergedDictionaries正确合并资源字典，否则可能查找不到 - 典型用法：
Background="{DynamicResource ErrorBrush}"、Text="{DynamicResource SaveButtonText}"
StaticResource：一次性解析，性能更轻量
适合不会改变的基础资源，如固定尺寸、预设图标 Geometry、静态样式键名等。
- 在 XAML 加载阶段（即控件初始化时）解析一次，之后不再追踪资源变化
- 要求资源必须在当前 XAML 文件中已声明，或已在父级资源字典中提前合并（不能跨未合并的字典延迟查找）
- 不适用于需要热切换的场景：改了资源值，界面不会自动重绘
- 典型用法：
ItemTemplate="{StaticResource MyDataTemplate}"、Content="{StaticResource AppLogoIcon}"
资源字典合并是 DynamicResource 起效的前提
单独定义资源字典文件（如 Colors.axaml）后，必须显式合并到作用域中，DynamicResource 才能访问到它。
- 全局合并（推荐）：
<Application.Resources>
<ResourceDictionary>
<ResourceDictionary.MergedDictionaries>
<ResourceInclude Source="/Resources/Colors.axaml"/>
<ResourceInclude Source="/Resources/Strings.zh-CN.axaml"/>
</ResourceDictionary.MergedDictionaries>
</ResourceDictionary>
</Application.Resources> - 局部合并（如仅某窗口需要）：
<Window.Resources>
<ResourceDictionary>
<ResourceDictionary.MergedDictionaries>
<ResourceInclude Source="/Views/MyViewTheme.axaml"/>
</ResourceDictionary.MergedDictionaries>
</ResourceDictionary>
</Window.Resources>
常见错误与避坑提示
-
用 StaticResource 绑定多语言文本：切换语言后文字不变——应改用
DynamicResource -
资源字典没合并就直接引用：报“Resource not found”异常——检查
MergedDictionaries是否生效 -
在 Style 中误用 StaticResource 引用动态色值：比如
Foreground="{StaticResource PrimaryTextColor}"，换深色主题时失效——应改为DynamicResource -
资源 Key 写错或大小写不一致：Avalonia 区分大小写，
"error"和"Error"是两个不同资源
