在Avalonia中给按钮同时添加图标和文字，最常用且推荐的方式是组合使用StackPanel（或Grid）嵌套图标控件与文本控件；也可用FontAwesome附加属性简化写法，或封装IconButton控件提升复用性。
在Avalonia中给按钮同时添加图标和文字，最常用且推荐的方式是组合使用 StackPanel（或 Grid）嵌套图标控件与文本控件。不依赖自定义控件也能快速实现，但若项目中频繁使用，建议封装为 IconButton 提升复用性。
直接在Button内嵌套布局（适合单次/少量使用）
以 Material.Icons.Avalonia 为例，先确保已安装包并配置好样式：
dotnet add package Material.Icons.Avalonia- 在
App.axaml的 - 在目标页面 XAML 顶部声明命名空间：
xmlns:materialIcons="clr-namespace:Material.Icons.Avalonia;assembly=Material.Icons.Avalonia"
然后这样写按钮：
注意：Width/Height 控制图标尺寸，Spacing 控制图标与文字间距，VerticalAlignment="Center" 确保图文垂直居中对齐。
用 FontAwesome 实现更灵活的图标绑定（支持动画/颜色/大小）
安装：dotnet add package Projektanker.Icons.Avalonia.FontAwesome
注册图标提供器（在 Program.cs 的 BuildAvaloniaApp() 中）：
IconProvider.Current.Register();
XAML 中使用（无需额外命名空间声明，只需启用附加属性）：
这种方式更简洁，图标自动居左、尺寸适配按钮高度，还支持：
- 设置图标颜色：
i:Attached.IconForeground="Blue" - 自定义大小：
FontSize="16"（影响图标和文字整体缩放） - 添加旋转动画：
i:Attached.IconAnimation="Spin"
封装 IconButton 控件（适合中大型项目）
避免重复写 StackPanel 嵌套，可创建一个带 IconKind 和 Content 属性的模板化控件：
- 新建
Controls/IconButton.axaml（Templated Control 类型） - 在后台类中定义两个依赖属性：
IconKind（string）和Content（object） - 模板中用
Grid或StackPanel排布： - 使用时只需：
这样既保持语义清晰，又统一了图标位置、间距、对齐逻辑，后续还能轻松加悬停效果或禁用态样式。
菜单项（MenuItem）中添加图标的小技巧
MenuItem 的 Icon 属性接受任意控件，所以可以直接塞入图标：
或手动嵌套（兼容所有图标库）：
注意：MenuItem 默认图标区域较窄，建议控制图标宽高 ≤ 16px，避免挤压文字。
