在 Avalonia 的 DataGrid 中显示图片，核心是使用
DataGridTemplateColumn自定义单元格模板，并在其中嵌入
Image控件绑定图片源。Avalonia 不提供原生的“图片列”（如 WPF 的
DataGridImageColumn），必须手动实现。
图片列的基本实现方式
适用于本地资源、嵌入式资源（
avares://）或 Base64 字符串等可被
Image.Source解析的格式： 确保数据模型中对应属性为
IBitmap、
string（路径或 URI）或
Stream；推荐用
IBitmap类型以获得最佳性能和类型安全 在 XAML 中用
DataGridTemplateColumn替代
DataGridTextColumn或
DataGridCheckBoxColumn
CellTemplate内放置
Image，设置
Width/
Height和
Stretch属性控制缩放行为
绑定本地图片资源（avares://）
若图片作为嵌入资源添加到项目（Build Action =
EmbeddedResource），可通过
avares://协议访问：
<DataGridTemplateColumn Header="图标" Width="60">
<DataGridTemplateColumn.CellTemplate>
<DataTemplate DataType="models:Item">
<Image Source="avares://YourApp/Assets/icon.png"
Width="24" Height="24"
HorizontalAlignment="Center" VerticalAlignment="Center"
Stretch="Uniform"/>
</DataTemplate>
</DataGridTemplateColumn.CellTemplate>
</DataGridTemplateColumn>
注意替换
YourApp为实际程序集名，路径区分大小写。
绑定模型中的图片路径或 IBitmap 属性
当模型含字符串路径（如
"./Images/check.png"）或已加载的
IBitmap实例时，直接绑定即可： 字符串路径需确保运行时可访问（如放在
bin/Debug下），建议转为
IBitmap更可靠 推荐在 ViewModel 中预加载：
public IBitmap Thumbnail { get; } = new Bitmap(AssetLoader.Open(new Uri("avares://...")))
XAML 绑定示例（假设属性名为 Thumbnail）：
<Image Source="{Binding Thumbnail}"
Width="32" Height="32"
Stretch="UniformToFill"
HorizontalAlignment="Center"/>
处理空值与加载失败
避免因
Source为空或无效导致渲染异常： 在
CellTemplate中加一层
Visibility判断：
Visibility="{Binding Thumbnail, Converter={StaticResource NullToCollapsedConverter}}"
或使用默认占位图（通过 Style+
Trigger，但 Avalonia 当前版本对
Image的
Trigger支持有限，更稳妥的是在 ViewModel 返回带 fallback 的
IBitmap） 调试技巧：F12 打开 Avalonia DevTools，检查 Image 元素是否报
Failed to load image错误，确认 URI 是否可解析
不复杂但容易忽略：图片尺寸未约束会导致列宽异常拉伸，务必显式设
Width/
Height或用
MaxWidth/
MaxHeight配合
Stretch控制呈现效果。
