Avalonia中通过ToolTip.Tip附加属性设置提示，支持文本、XAML结构和数据绑定；后台可用ToolTip.SetTip动态设置；macOS需禁用硬件加速防崩溃，并注意模板嵌套与滚动兼容性。

在Avalonia中给控件添加ToolTip提示很简单，核心是设置ToolTip.Tip附加属性，支持纯文本、XAML结构甚至绑定数据。

直接在XAML里设置静态提示

最常用的方式是在控件标签内直接写ToolTip.Tip，值可以是字符串：

<Button Content="保存" ToolTip.Tip="点击保存当前编辑内容" />

也可以用多行富文本结构，比如嵌套StackPanel和多个TextBlock：

<Button Content="导出">
  <ToolTip.Tip>
    <StackPanel>
      <TextBlock>导出为Excel格式</TextBlock>
      <TextBlock FontSize="12" Foreground="Gray">支持.xlsx与.csv</TextBlock>
    </StackPanel>
  </ToolTip.Tip>
</Button>

后台代码动态设置提示内容

适合运行时根据状态更新提示，用ToolTip.SetTip方法：

QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载

• ToolTip.SetTip(myButton, "正在处理中…");
• ToolTip.SetTip(textBlock, new TextBlock { Text = "只读字段，不可编辑" });
• 支持任意UI元素（不只是字符串），比如带图标或布局的控件

配合绑定和模板使用

如果提示内容来自ViewModel，可直接绑定：

<TextBox Text="{Binding Name}" ToolTip.Tip="{Binding NameTooltip}" />

注意：若提示文本过长，建议加TextTrimming="CharacterEllipsis"防止溢出，例如：

<TextBlock Text="{Binding Code}" ToolTip.Tip="{Binding FullDescription}" TextTrimming="CharacterEllipsis" />

macOS平台注意事项

在macOS（尤其是Monterey及更新版本）上，ToolTip可能触发崩溃，常见原因包括渲染线程冲突或窗口层级异常：

• 临时规避：在App.xaml中对macOS禁用硬件加速：<OnPlatform x:TypeArguments="RenderOptions" macOS:DisableHardwareAcceleration="True" />
• 避免在自定义UserControl模板里重复嵌套ContentPresenter，否则可能导致ToolTip内容不显示
• 复杂ToolTip（如含ScrollView）需测试滚动是否生效，macOS下鼠标滚轮有时不响应

基本上就这些。ToolTip本身轻量易用，但跨平台细节容易忽略，尤其macOS上线性渲染逻辑更敏感。