MAUI手势操作通过声明式手势识别器实现，核心是识别意图而非处理底层触摸。常用类型包括Tap、LongPress、Swipe、Pan、Pinch五种，支持XAML绑定命令和代码动态添加，需注意手势冲突与交互启用设置。
MAUI 手势操作不是靠监听原始触摸事件，而是通过内置的
手势识别器（Gesture Recognizers）
声明式添加到控件上，再绑定命令或事件来响应。核心思路是：**识别意图，而非处理底层指针**。它天然支持 MVVM，也兼容代码后台写法，跨平台行为一致。
常用手势识别器有哪些
所有识别器都通过
集合添加到任意
（如
、
、
等）。主要类型包括：
TapGestureRecognizer
：单击、双击（设
），最常用
LongPressGestureRecognizer
：长按（可设
，默认 500ms）
SwipeGestureRecognizer
：左右/上下快速滑动，支持
属性
PanGestureRecognizer
：持续拖拽，提供实时位移（
/
）和状态（
/
）
PinchGestureRecognizer
：双指缩放，返回缩放比例变化（
）和中心点
怎么用 XAML 绑定点击命令（MVVM 推荐）
以点击一张图片跳转详情页为例，ViewModel 中定义命令，XAML 中绑定：
ViewModel 中只需暴露一个
：
这样完全解耦，测试方便，也避免内存泄漏风险。
怎么在代码里动态加手势（比如运行时控制）
适合需要条件启用/禁用、或逻辑较复杂的情况。例如给一个
添加拖拽功能：
注意：不用时可调用
移除，防止重复注册。
手势冲突怎么处理
同一控件加了多个手势（比如 Tap + Pan），系统默认按添加顺序竞争，但可能误判。关键控制点有两个：
：允许其他手势“抢走”事件（例如设为 false 后，Pan 不会阻止 Tap）
：让当前手势持续接收后续触摸（适合需要多阶段响应的场景）
典型做法是：对主交互控件（如地图、画布），优先加
或
，再把
放后面，并设
，确保滑动时不意外触发点击。
基本上就这些。不复杂但容易忽略的是：手势识别器本身不自动启用交互（比如
默认
是 OK 的，但
如果父容器拦截了触摸，就得检查层级和透明设置）。
GestureRecognizersViewLabelImageFrameNumberOfTapsRequired="2"DurationMillisecondsDirectionTotalXTotalYRunningCompletedScale
ICommandpublic ICommand NavigateToProfileCommand { get; } = new Command(async (userId) =>
{
await Shell.Current.GoToAsync($"profile/{userId}");
}); BoxViewvar pan = new PanGestureRecognizer();
pan.PanUpdated += (s, e) =>
{
if (e.StatusType == GestureStatus.Running)
{
boxView.TranslationX += e.TotalX;
boxView.TranslationY += e.TotalY;
}
else if (e.StatusType == GestureStatus.Completed)
{
// 拖完自动归位或吸附
boxView.TranslateTo(0, 0, 150);
}
};
boxView.GestureRecognizers.Add(pan);boxView.GestureRecognizers.Clear()CanBePrevented="False"CanContinueToReceiveTouches="True"PanPinchTapCanBePrevented="True"ImageInputTransparent="False"Label