Avalonia 中可通过 StyleInclude 将样式提取到独立 .axaml 文件实现复用与解耦，支持全局（App.axaml）或局部（UserControl/Window）引入，路径格式为 resm: 命名空间?assembly=程序集 或相对路径，需注意生成操作、大小写及 Selector 语法。
在 Avalonia 中，可以通过 StyleInclude 将 XAML 样式提取到独立的资源文件中，实现样式复用与维护解耦。
创建独立样式文件
新建一个 .axaml 文件（例如 CommonStyles.axaml），并在根节点使用 Styles 容器声明样式：
在主资源字典中引入样式文件
在 App.axaml 或窗口/用户控件的 Styles 节点中，用 StyleInclude 加载外部样式：
-
路径格式：使用
resm:协议 + 命名空间路径 +?assembly=，确保文件生成操作为EmbeddedResource -
相对路径：若样式文件与引用方在同一程序集且同级目录，可简写为
Source="CommonStyles.axaml"（需设为Resource类型） - 加载顺序：先加载的样式可被后加载的覆盖，适合做基础样式 + 主题覆盖
在 UserControl 或 Window 中局部使用
除全局注册外，也可在单个控件内部按需引入：
- 适用于仅在特定界面生效的定制样式
- 避免污染全局样式表，提升模块隔离性
- 支持嵌套
StyleInclude，但注意循环引用风险
验证与调试技巧
样式未生效时可检查以下几点：
- 确认样式文件的 生成操作（Build Action） 是
EmbeddedResource（用resm:）或Resource（用相对路径） - 检查
Source中的命名空间和程序集名称是否与实际一致（大小写敏感） - 在开发者工具（F12）中查看“Resources”面板，确认样式是否已加载
- Selector 语法是否正确，比如类选择器要写成
Button.primary而非Button（后者是伪类，需配合:pressed等使用）
