Unity中Input.mousePosition为何在UI遮挡时仍返回屏幕坐标？

Question

在Unity中，开发者常困惑：为何即使Canvas UI（如Button、Image）完全遮挡摄像机视图，`Input.mousePosition` 仍持续返回屏幕坐标（如(320, 480)），而非返回null或触发“被阻挡”信号？这是因为`Input.mousePosition`本质是**底层输入系统提供的原始鼠标/触控设备像素位置**，与场景渲染、UI层级、射线检测（Raycast）完全解耦——它不感知UI是否存在，也不参与Graphic Raycaster的事件分发流程。其值仅受操作系统输入驱动影响，每帧稳定更新，与Canvas Render Mode（Screen Space Overlay/ Camera）、Raycast Target开关、Mask组件等UI交互逻辑无关。真正决定“点击是否命中UI”的是`EventSystem.RaycastAll()`和`PointerEventData`的传播机制，而非`Input.mousePosition`本身。因此，将`Input.mousePosition`误当作“有效点击位置”直接用于世界坐标转换（如`Camera.ScreenToWorldPoint`），却忽略UI遮挡校验，极易导致逻辑错误（如UI按钮上仍触发背景对象拖拽）。正确做法应结合`EventSystem.current.IsPointerOverGameObject()`或自定义射线检测进行前置判断。

Answer 1

```html

一、现象层：为何 Input.mousePosition 从不“失联”？

无论 Canvas 是 Screen Space - Overlay 还是 World Space，无论 Button 是否启用 Raycast Target、是否被 Mask 遮蔽，Input.mousePosition 始终稳定返回非空的屏幕像素坐标（如 (320, 480)）。这不是 Bug，而是设计契约——它本质是操作系统输入子系统（Windows Raw Input / macOS HID / Android MotionEvent）向 Unity 引擎暴露的**设备级原始坐标流**，与渲染管线、UI层级、摄像机裁剪完全无关。

二、架构层：Unity 输入栈的三层解耦模型

• Layer 1（硬件抽象层）：OS 驱动上报的绝对屏幕像素位置，单位为像素，原点在左下角（Unity 自动翻转 Y 轴适配左上原点）
• Layer 2（引擎输入层）：Input 类仅做轻量封装，无射线检测、无 UI 感知、无帧间插值逻辑
• Layer 3（事件分发层）：由 EventSystem + GraphicRaycaster + PointerEventData 构成独立事件管道，与 Layer 1/2 同步但异步解耦

三、误区诊断：开发者高频误用模式

错误写法	风险后果	根本原因
var worldPos = cam.ScreenToWorldPoint(Input.mousePosition);	UI 上点击仍触发背景物体拖拽/拾取	未校验指针是否正位于可交互 UI 元素之上
if (Input.GetMouseButtonDown(0)) { /* 直接处理 */ }	按钮点击时同时触发 UI 和场景逻辑（双重响应）	混淆了“输入发生”与“交互有效”的语义边界

四、正确实践：双通道防御式交互判定

必须组合使用以下两种机制之一（推荐二者并用）：

1. EventSystem.current.IsPointerOverGameObject() —— 快速粗筛（含触摸 ID 支持）
2. 自定义射线检测：GraphicRaycaster.Raycast() 或 Physics.Raycast()（按需选择）

五、代码示例：鲁棒的点击世界坐标转换

void Update() {
    if (Input.GetMouseButtonDown(0)) {
        // ✅ 第一步：检查指针是否悬停于任意 GameObject（含 UI）
        if (EventSystem.current.IsPointerOverGameObject()) return;

        // ✅ 第二步：确认摄像机有效且鼠标在视口内
        Camera mainCam = Camera.main;
        if (mainCam == null) return;
        Vector3 screenPos = Input.mousePosition;
        if (!RectTransformUtility.RectangleContainsScreenPoint(mainCam.pixelRect, screenPos))
            return;

        // ✅ 第三步：执行带深度校验的世界坐标转换
        Ray ray = mainCam.ScreenPointToRay(screenPos);
        if (Physics.Raycast(ray, out RaycastHit hit, 100f, layerMask)) {
            Debug.Log($"Hit world position: {hit.point}");
        }
    }
}

六、进阶洞察：Overlay 模式下的特殊陷阱

在 Screen Space - Overlay 下，Canvas 不经过摄像机渲染，Camera.WorldToScreenPoint() 对其无效；但 Input.mousePosition 依然可用——这进一步印证其与渲染路径零耦合。若需将 UI 坐标映射到世界空间（如拖拽 UI 元素同步控制 3D 对象），必须通过 RectTransformUtility.WorldToScreenPoint() 反向桥接，并显式处理 Canvas Render Mode 差异。

七、流程图：UI 遮挡判定决策流

flowchart TD
    A[Input.GetMouseButtonDown] --> B{IsPointerOverGameObject?}
    B -->|Yes| C[终止世界坐标处理]
    B -->|No| D[ScreenToWorldPoint or Raycast]
    D --> E{Raycast Hit?}
    E -->|Yes| F[执行业务逻辑]
    E -->|No| G[忽略或 fallback]

```