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才能访问到它。 全局合并（推荐）：
局部合并（如仅某窗口需要）：
常见错误与避坑提示
用 StaticResource 绑定多语言文本：切换语言后文字不变——应改用DynamicResource资源字典没合并就直接引用：报“Resource not found”异常——检查
MergedDictionaries是否生效 在 Style 中误用 StaticResource 引用动态色值：比如
Foreground="{StaticResource PrimaryTextColor}"，换深色主题时失效——应改为 DynamicResource资源 Key 写错或大小写不一致：Avalonia 区分大小写，
"error"和
"Error"是两个不同资源
