在 MAUI 中实现圆形头像，核心是让图像（
Image）被一个带圆角的容器裁剪，最常用、最可靠的方式是用
Frame包裹
Image，并设置
CornerRadius为宽高一半，同时开启裁剪（
Clip）——但注意：MAUI 的
Frame默认不支持裁剪内容，真正起作用的是
Clip属性本身，或更推荐使用
Border+
Clip（.NET 8+），不过对圆形头像，一个简洁有效的方案是直接给
Image设置
Clip为圆形
EllipseGeometry。
✅ 推荐方式：直接给 Image 设置 Clip（最干净、无嵌套）
这是 MAUI 官方推荐做法，无需 Frame，避免额外布局开销，且完全可控。
确保Image的宽高相等（如
WidthRequest="100" HeightRequest="100"） 设置
Clip属性为一个居中、半径为宽高一半的椭圆几何体 代码示例（XAML）：
<Image Source="avatar.jpg"
WidthRequest="100"
HeightRequest="100"
Aspect="AspectFill">
<Image.Clip>
<EllipseGeometry Center="50,50" RadiusX="50" RadiusY="50" />
</Image.Clip>
</Image>
? 提示：Center 值 = WidthRequest/2, HeightRequest/2；RadiusX/Y 也取该值。若用绑定或动态尺寸，可用
BindingContext或后台代码动态计算。
⚠️ Frame 圆角的常见误区（不直接实现圆形）
Frame的
CornerRadius只控制自身边框圆角，**不会裁剪子元素**。即使你把
CornerRadius设为 50，里面放一张方形图，图依然会溢出显示为方形。 错误写法（头像仍是方形）：
Clip（作用于 Frame 自身）：
<Frame WidthRequest="100" HeightRequest="100" CornerRadius="50">
<Frame.Clip>
<EllipseGeometry Center="50,50" RadiusX="50" RadiusY="50" />
</Frame.Clip>
<Image Source="avatar.jpg" Aspect="AspectFill" />
</Frame>
⚠️ 注意：此时 Clip 是 Frame 的，不是 Image 的；且 Frame 内容默认居中，需确保 Image 尺寸撑满或设
HorizontalOptions="Fill"等。
? 补充技巧：适配不同尺寸与深色模式
用Style统一定义圆形头像样式，便于复用 结合
AppThemeBinding动态设置边框颜色（如浅色下灰色边框、深色下浅灰） 添加简单边框？可在
Frame上设
StrokeThickness和
Stroke（.NET 8+ 支持） 需要点击响应？外层包
TapGestureRecognizer到 Image 或 Frame
? 总结关键点
圆形头像 = 等宽高等比例图像 +Clip为
EllipseGeometry优先直接 Clip Image，语义清晰、性能好 Frame 的 CornerRadius ≠ 裁剪，只是描边圆角；要裁成圆，必须显式设置 Clip 务必保证宽高一致，否则 EllipseGeometry 会变成椭圆
基本上就这些。不复杂但容易忽略 Clip 和尺寸匹配这两个关键细节。
