Avalonia如何将XAML样式分离到单独文件 Avalonia StyleInclude

来源：这里教程网时间：2026-02-21 17:38:21 作者：

在 Avalonia 中，可以通过

StyleInclude

将 XAML 样式提取到独立的资源文件中，实现样式复用与维护解耦。

创建独立样式文件

新建一个

.axaml

文件（例如

CommonStyles.axaml

），并在根节点使用

Styles

容器声明样式：

<Styles xmlns="https://github.com/avaloniaui">
  <Style Selector="Button<primary>">
    <Setter Property="Background" Value="DodgerBlue"/>
  </Style>
  <Style Selector="TextBlock.hint">
    <Setter Property="Foreground" Value="#999"/>
  </Style>
</Styles>

在主资源字典中引入样式文件

在

App.axaml

或窗口/用户控件的

Styles

节点中，用

StyleInclude

加载外部样式：

<Application.Styles>
  <Styles>
    <!-- 引入本地样式文件 -->
    <StyleInclude Source="resm:MyApp.Styles.CommonStyles.axaml?assembly=MyApp"/>
    <!-- 也可引用程序集内其他路径或 NuGet 包中的样式 -->
  </Styles>
</Application.Styles>

路径格式：使用
resm:
协议 + 命名空间路径 +
?assembly=
，确保文件生成操作为
EmbeddedResource
相对路径：若样式文件与引用方在同一程序集且同级目录，可简写为
Source="CommonStyles.axaml"
（需设为
Resource
类型） 加载顺序：先加载的样式可被后加载的覆盖，适合做基础样式 + 主题覆盖

在 UserControl 或 Window 中局部使用

除全局注册外，也可在单个控件内部按需引入：

<UserControl.Styles>
  <Styles>
    <StyleInclude Source="resm:MyApp.Controls.ButtonStyles.axaml?assembly=MyApp"/>
  </Styles>
</UserControl.Styles>

适用于仅在特定界面生效的定制样式 避免污染全局样式表，提升模块隔离性 支持嵌套
StyleInclude
，但注意循环引用风险

验证与调试技巧

样式未生效时可检查以下几点：

确认样式文件的 生成操作（Build Action） 是
EmbeddedResource
（用
resm:
）或
Resource
（用相对路径）检查
Source
中的命名空间和程序集名称是否与实际一致（大小写敏感） 在开发者工具（F12）中查看“Resources”面板，确认样式是否已加载 Selector 语法是否正确，比如类选择器要写成
Button.primary
而非
Button<primary></primary>
（后者是伪类，需配合
:pressed
等使用）