17370845950

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 才能访问到它。

• 全局合并（推荐）：
  
    
      
        
        
      
    
  
• 局部合并（如仅某窗口需要）：
  
    
      
        
      
    
  

常见错误与避坑提示

• 用 StaticResource 绑定多语言文本：切换语言后文字不变——应改用 DynamicResource
• 资源字典没合并就直接引用：报“Resource not found”异常——检查 MergedDictionaries 是否生效
• 在 Style 中误用 StaticResource 引用动态色值：比如 Foreground="{StaticResource PrimaryTextColor}"，换深色主题时失效——应改为 DynamicResource
• 资源 Key 写错或大小写不一致：Avalonia 区分大小写，"error" 和 "Error" 是两个不同资源