avalonia 中可通过 styleinclude 将样式提取到独立 .axaml 文件实现复用与解耦，支持全局（app.axaml）或局部（usercontrol/window）引入，路径格式为 resm: 命名空间?assembly=程序集 或相对路径，需注意生成操作、大小写及 selector 语法。
在 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等使用）
