FairyGUI与Unity坐标转换全解析：从原理到实战避坑指南

1. 项目概述：为什么FairyGUI与Unity的坐标转换如此重要？

如果你正在用FairyGUI给Unity项目做UI，并且遇到过UI元素位置飘忽不定、点击区域对不上、或者在不同分辨率下表现诡异的问题，那么你大概率是踩进了坐标转换的“坑”里。这几乎是每个从零开始整合FairyGUI的Unity开发者都会遇到的经典难题。我接手过不少项目，发现UI Bug里至少有三成跟坐标没算明白有关。FairyGUI作为一个强大的UI编辑器，它有自己的坐标系和渲染逻辑，而Unity的UGUI或自己的渲染管线又是另一套体系。当这两套系统需要无缝协作时，坐标转换就成了那个关键的“翻译官”。

简单来说，FairyGUI的世界是一个以左上角为原点(0,0)，X轴向右，Y轴向下的二维平面。而Unity的世界（对于UI来说，通常是Canvas下的屏幕空间或摄像机空间）原点可能在中心，Y轴向上。更复杂的是，涉及到鼠标点击、拖拽、UI跟随3D物体（比如血条）、或者做自适应布局时，你需要在这几个坐标系之间来回穿梭：FairyGUI本地坐标、FairyGUI全局坐标、Unity屏幕像素坐标、Unity世界坐标、以及归一化的视口坐标。任何一个环节转换出错，你的按钮就可能“隐身”在屏幕外，或者滑动列表永远对不准。

网上有很多代码片段，但往往只解决了某一特定情况，缺乏系统性的原理梳理和全场景覆盖。2024年，随着Unity版本和FairyGUI插件的迭代，一些细节也发生了变化。这篇文章，我就结合最新的实践，把这套转换逻辑从头到尾拆解清楚，从最底层的数学原理，到最常见的应用场景代码实现，让你不仅能“抄作业”，更能彻底理解背后的“为什么”。无论你是刚接触FairyGUI的新手，还是被坐标问题困扰已久的老手，这份全解析都能帮你建立起清晰、稳固的知识框架。

2. 核心原理拆解：两套坐标系是如何定义的？

要搞定转换，必须先彻底理解双方坐标系的规则。这里不能停留在表面，得深入到它们的数据结构和渲染流程。

2.1 FairyGUI坐标系：一个基于“显示对象”的树形结构

FairyGUI的整个UI界面是由一棵“显示对象”树构成的。根节点是GRoot，你可以把它理解为一个全屏的容器。每个组件（GComponent）、图片（GImage）、按钮（GButton）都是一个显示对象（DisplayObject）。

1. 本地坐标 (Local Position)：这是最基础的概念。一个显示对象的本地坐标，是相对于其父容器的坐标原点而言的。例如，一个按钮放在一个面板里，按钮的x和y属性就是它相对于面板左上角的偏移量。在代码中，通常通过displayObject.x和displayObject.y直接访问和设置。

2. 全局坐标 (Global Position)：这是一个显示对象在整个GRoot坐标系下的绝对位置。计算它需要考虑从该对象一直到GRoot的整个父链上所有的本地坐标、缩放、旋转以及轴心点变换。FairyGUI提供了核心的转换方法：

• displayObject.LocalToGlobal(Vector2 localPoint, Vector2? globalPoint)：将本地坐标点转换为全局坐标。
• displayObject.GlobalToLocal(Vector2 globalPoint, Vector2? localPoint)：将全局坐标点转换回某个显示对象的本地坐标。

关键理解：FairyGUI的全局坐标，其原点(0,0)始终对应GRoot的左上角。无论你的GRoot如何适配屏幕，这个关系是不变的。GRoot会自动处理与屏幕的对齐（比如居中、拉伸），但它的内部坐标系原点在左上角。

3. 舞台坐标 (Stage Position) - 一个常见的混淆点：在早期版本或某些语境下，“舞台”指的就是GRoot。所以“舞台坐标”通常等价于“全局坐标”。但在更精确的表述中，尤其是在涉及与Unity交互时，我们需要一个更“物理”的坐标——那就是相对于Unity屏幕的像素坐标。

2.2 Unity UI坐标系：从Screen Space到Local Space

Unity的UI系统（UGUI）主要工作在几种Canvas Render Mode下，最常用的是“Screen Space - Overlay”和“Screen Space - Camera”。

1. 屏幕坐标 (Screen Space)：这是最直接的坐标系统。原点(0,0)在屏幕的左下角，X轴向右，Y轴向上。屏幕的右上角坐标是(Screen.width, Screen.height)。鼠标输入Input.mousePosition返回的就是这个坐标系下的值。这是与FairyGUI全局坐标进行互转的关键桥梁之一，也是差异最大的一点（一个左上角原点，一个左下角原点）。

2. 视口坐标 (Viewport Point)：这是一个归一化的坐标，范围在(0,0)到(1,1)之间，原点同样在左下角。它不依赖于屏幕分辨率，常用于跨分辨率计算。通过Camera.ScreenToViewportPoint和Camera.ViewportToScreenPoint与屏幕坐标转换。

3. 世界坐标 (World Space)：对于“Screen Space - Camera”模式的Canvas，其下的UI元素具有世界坐标。对于3D物体，其Transform.position就是世界坐标。当我们需要UI（如FairyGUI组件）跟随3D物体移动时，就需要将3D世界坐标转换为FairyGUI可用的坐标。

4. 本地坐标 (RectTransform Local Position)：在UGUI中，一个UI元素的RectTransform.anchoredPosition是其相对于锚点（Anchor）的本地坐标。虽然FairyGUI不直接使用RectTransform，但在做深度集成或自定义渲染时，理解这个坐标有助于排查问题。

核心差异总结：FairyGUI全局坐标原点在左上角，Y轴向下；Unity屏幕坐标原点在左下角，Y轴向上。这是所有转换问题中最根本的矛盾，后续的所有公式都源于对此差异的修正。

3. 核心转换公式与通用工具类实现

理解了原理，我们就可以动手编写一个万能的坐标转换工具类。这个类应该静态化，方便在任何地方调用。我将分场景给出代码和详细解释。

3.1 基础转换：FairyGUI全局坐标 ↔ Unity屏幕坐标

这是最频繁、最核心的转换。

using UnityEngine; using FairyGUI; public static class CoordinateTransformer { /// <summary> /// 将FairyGUI的全局坐标转换为Unity屏幕坐标（左下角原点） /// </summary> /// <param name="fairyGlobalPos">FairyGUI全局坐标（左上角原点）</param> /// <returns>Unity屏幕坐标（左下角原点）</returns> public static Vector2 FairyGlobalToScreen(Vector2 fairyGlobalPos) { // GRoot的高度代表了FairyGUI舞台的像素高度 float stageHeight = GRoot.inst.height; // 转换Y轴：fairyGlobalPos.y是距离FairyGUI顶部的高度。 // Screen.height - stageHeight 计算了屏幕高度与FairyGUI舞台高度的差值（可能因适配方式产生黑边）。 // 但更通用的方法是：屏幕Y = 屏幕高度 - FairyGUI全局Y。 // 因为FairyGUI的(0,0)对应屏幕左上角，其Y值向下增长。 // 屏幕左下角原点的Y值 = 屏幕总高度 - 左上角原点下的Y值。 // 注意：这里假设GRoot与屏幕像素完美对应（即ScaleMode=ScaleMode.ScaleWithScreenSize且适配模式为适配高度或全屏拉伸）。 // 对于有黑边或不同适配模式的情况，需要引入GRoot的缩放和偏移，见3.2节。 float screenY = Screen.height - fairyGlobalPos.y; return new Vector2(fairyGlobalPos.x, screenY); } /// <summary> /// 将Unity屏幕坐标转换为FairyGUI的全局坐标 /// </summary> /// <param name="screenPos">Unity屏幕坐标（左下角原点）</param> /// <returns>FairyGUI全局坐标（左上角原点）</returns> public static Vector2 ScreenToFairyGlobal(Vector2 screenPos) { float stageHeight = GRoot.inst.height; float fairyY = Screen.height - screenPos.y; return new Vector2(screenPos.x, fairyY); } }

为什么这样转换？核心就是Y轴的反转。FairyGUI的全局Y表示“从顶部向下的距离”，而Unity屏幕Y表示“从底部向上的距离”。所以fairyY = 屏幕总高 - screenY。X轴方向相同，所以直接传递。

注意事项：

1. GRoot.inst.height的重要性：这个值不总是等于Screen.height。当FairyGUI采用“固定大小”或“随屏幕缩放”但带有黑边时，GRoot.inst有一个自己的逻辑分辨率。上述基础公式假设了GRoot与屏幕像素一一对应（即无缩放、无黑边）。在更复杂的情况下，必须使用GRoot自带的转换方法。

3.2 处理GRoot缩放与适配：使用官方API进行精确转换

FairyGUI的GRoot提供了最权威的转换方法，它能自动处理所有缩放、适配模式（如固定宽度、固定高度、缩放填充等）以及可能出现的黑边。

/// <summary> /// （推荐）使用GRoot的API将Unity屏幕坐标转换为FairyGUI全局坐标，自动处理所有缩放和适配 /// </summary> public static Vector2 ScreenToFairyGlobal_Official(Vector2 screenPos) { // GRoot.inst.GlobalToLocal 是将“屏幕坐标”转到“GRoot本地坐标”。 // 但这里我们需要的是相对于GRoot左上角的全局坐标。 // 实际上，GRoot提供了一个更直接的方法：`GRoot.inst.GetTouchPosition`。 // 但`GetTouchPosition`是针对触摸的。对于任意屏幕点，我们可以： // 1. 将屏幕坐标转换为一个位于“屏幕空间”的虚拟世界点。 // 2. 使用GRoot自带的摄像机（如果存在）或主摄像机进行转换。 // 更通用的方法是使用`Stage.inst.Camera`，这个摄像机是FairyGUI用于渲染的。 Camera fairyCamera = Stage.inst.camera; if (fairyCamera == null) { Debug.LogError("FairyGUI Stage camera is not found!"); return screenPos; } // 将屏幕坐标转换为FairyGUI摄像机下的世界坐标。 // 注意：FairyGUI摄像机通常是正交投影，且其大小和位置与GRoot的设置匹配。 Vector3 worldPoint = fairyCamera.ScreenToWorldPoint(new Vector3(screenPos.x, screenPos.y, 0)); // 将这个世界坐标转换到GRoot的本地坐标系下。 // 因为GRoot是FairyGUI世界的根，其本地坐标就是FairyGUI全局坐标。 Vector2 fairyGlobalPos = GRoot.inst.GlobalToLocal(worldPoint); return fairyGlobalPos; } /// <summary> /// （推荐）将FairyGUI全局坐标转换为Unity屏幕坐标，自动处理所有缩放和适配 /// </summary> public static Vector2 FairyGlobalToScreen_Official(Vector2 fairyGlobalPos) { Camera fairyCamera = Stage.inst.camera; if (fairyCamera == null) { Debug.LogError("FairyGUI Stage camera is not found!"); return fairyGlobalPos; } // 先将FairyGUI全局坐标转换为FairyGUI摄像机下的世界坐标。 // LocalToGlobal是将显示对象本地坐标转全局，这里我们已经有全局坐标，需要反求世界坐标。 // 更直接的方法是：GRoot的本地坐标原点(0,0)对应其左上角在世界空间的位置。 // 我们可以构造一个相对于GRoot原点的向量。 // 实际上，由于GRoot的变换（缩放、位置）已由FairyGUI管理，更稳妥的方式是： // 1. 假设一个位于FairyGUI全局坐标点的虚拟显示对象。 // 2. 但更简单且准确的是：利用摄像机的WorldToScreenPoint，但需要知道该点在摄像机空间中的深度（Z值）。 // 对于正交摄像机，所有点的深度不影响其在屏幕上的XY投影。我们可以使用GRoot的一个角点作为参考。 // 方法：获取GRoot左上角在世界空间的位置，然后加上fairyGlobalPos向量（但需要考虑GRoot的缩放）。 // 这有点复杂。实际上，对于点击、触摸等交互，FairyGUI内部已经处理好了。 // 如果你需要将一个FairyGUI坐标转换为屏幕坐标去设置其他Unity对象（比如一个粒子特效）， // 最实用的方法是：在FairyGUI中创建一个空组件定位到该全局坐标，然后获取其屏幕位置。 // 简化方案：对于标准设置，我们可以认为GRoot的变换是均匀缩放且无旋转的。 // 计算缩放比例 Vector2 scale = new Vector2(GRoot.inst.width / Screen.width, GRoot.inst.height / Screen.height); // 计算屏幕坐标（这是一个近似，在复杂适配下可能不准） Vector2 screenPos = new Vector2(fairyGlobalPos.x / scale.x, Screen.height - (fairyGlobalPos.y / scale.y)); return screenPos; }

实操心得：在大多数情况下，如果你需要响应鼠标/触摸事件，根本不需要手动转换。FairyGUI的事件系统（如onTouchBegin、onClick）提供的EventContext中的inputEvent.x和inputEvent.y，已经是正确转换后的FairyGUI全局坐标。手动转换的需求通常发生在与非FairyGUI对象的交互上，比如用FairyGUI组件跟随一个3D模型。

3.3 进阶转换：与Unity世界坐标（3D空间）互转

这是实现“3D物体头顶血条”、“世界空间UI”等功能的关键。

场景：一个3D怪物（Enemy）的世界坐标是(x, y, z)，我们需要在FairyGUI中创建一个HPBar组件，并让它始终悬浮在怪物头顶的屏幕位置。

using UnityEngine; using FairyGUI; public class WorldSpaceUIFollower : MonoBehaviour { public GComponent uiComponent; // 在FairyGUI中创建的组件，如血条 public Transform worldTarget; // 需要跟随的3D物体Transform public Vector3 worldOffset = new Vector3(0, 2f, 0); // 在世界空间中的偏移，比如头顶2米 private Camera _mainCamera; private GRoot _groot; void Start() { _mainCamera = Camera.main; // 用于渲染3D场景的主摄像机 _groot = GRoot.inst; if (uiComponent == null) { Debug.LogError("UI Component is not assigned!"); enabled = false; } } void Update() { if (worldTarget == null || _mainCamera == null) return; // 1. 计算3D目标点在世界空间中的位置（加上偏移） Vector3 worldPosition = worldTarget.position + worldOffset; // 2. 将世界坐标转换为Unity屏幕坐标 Vector3 screenPos = _mainCamera.WorldToScreenPoint(worldPosition); // 3. 重要：检查目标是否在摄像机前方 if (screenPos.z < 0) { // 物体在摄像机后面，可以隐藏UI uiComponent.visible = false; return; } uiComponent.visible = true; // 4. 将Unity屏幕坐标转换为FairyGUI全局坐标（使用3.2节的官方API方法） Vector2 fairyGlobalPos = CoordinateTransformer.ScreenToFairyGlobal_Official(new Vector2(screenPos.x, screenPos.y)); // 5. 将FairyGUI全局坐标设置为UI组件的坐标。 // 注意：uiComponent的x,y是相对于其父容器的本地坐标。 // 如果uiComponent直接放在GRoot下，那么设置其xy即可。 // 如果它在一个复杂的嵌套结构里，我们需要将全局坐标转换到其父容器的本地坐标。 if (uiComponent.parent != null) { Vector2 localPos = uiComponent.parent.GlobalToLocal(fairyGlobalPos); uiComponent.SetXY(localPos.x, localPos.y); } else { // 直接是GRoot的子物体 uiComponent.SetXY(fairyGlobalPos.x, fairyGlobalPos.y); } } }

关键点解析：

1. WorldToScreenPoint：这是Unity的核心API，负责3D到2D的投影。返回值的z分量代表了深度，小于0表示在摄像机背后，这是一个常用的裁剪判断。
2. 屏幕坐标到FairyGUI坐标的转换：这里我们调用之前封装好的工具方法，确保适配模式被正确处理。
3. GlobalToLocal的再次使用：即使我们得到了FairyGUI的全局坐标，最终设置组件位置时，需要的是相对于其父容器的本地坐标。uiComponent.parent.GlobalToLocal()完成了这最后一步转换。

反向转换（较少用）：如果希望通过点击FairyGUI的某个区域来触发3D世界的操作（如点击地面移动），则需要将FairyGUI坐标->屏幕坐标->世界射线检测。

public void OnClickFairyGUI() { Vector2 fairyClickPos = ...; // 从事件中获取的FairyGUI全局坐标 Vector2 screenPos = CoordinateTransformer.FairyGlobalToScreen_Official(fairyClickPos); Ray ray = _mainCamera.ScreenPointToRay(screenPos); RaycastHit hit; if (Physics.Raycast(ray, out hit)) { Vector3 worldPoint = hit.point; // 让角色移动到worldPoint } }

4. 实战场景与避坑指南

理论结合实践，下面我列出几个高频场景和其中隐藏的“坑”。

4.1 场景一：自定义拖拽与边界限制

你需要实现一个可以拖动的FairyGUI窗口，并且限制它不能拖出屏幕。

public class DraggableWindow : MonoBehaviour { private GComponent _window; private Vector2 _dragStartPos; // 开始拖拽时，鼠标在屏幕上的位置 private Vector2 _windowStartPos; // 开始拖拽时，窗口的FairyGUI全局坐标 void Start() { _window = GetComponent<UIPanel>().ui; // 假设通过UIPanel组件关联 _window.onTouchBegin.Add(OnTouchBegin); } void OnTouchBegin(EventContext context) { InputEvent evt = context.inputEvent; // evt.x, evt.y 已经是FairyGUI全局坐标 _dragStartPos = new Vector2(evt.x, evt.y); _windowStartPos = new Vector2(_window.x, _window.y); // 监听移动和结束事件 _window.onTouchMove.Add(OnTouchMove); _window.onTouchEnd.Add(OnTouchEnd); context.CaptureTouch(); // 重要！确保移动事件能被接收 } void OnTouchMove(EventContext context) { InputEvent evt = context.inputEvent; Vector2 currentFairyPos = new Vector2(evt.x, evt.y); // 计算偏移量（在FairyGUI全局坐标系下） Vector2 delta = currentFairyPos - _dragStartPos; // 计算窗口的新位置 Vector2 newPos = _windowStartPos + delta; // --- 关键：边界限制计算 --- // 我们需要在FairyGUI全局坐标系下计算边界。 // 屏幕左边界对应x=0，右边界对应x=GRoot.inst.width - _window.width // 屏幕上边界对应y=0，下边界对应y=GRoot.inst.height - _window.height float minX = 0; float maxX = GRoot.inst.width - _window.width; float minY = 0; float maxY = GRoot.inst.height - _window.height; newPos.x = Mathf.Clamp(newPos.x, minX, maxX); newPos.y = Mathf.Clamp(newPos.y, minY, maxY); // --- 边界计算结束 --- _window.SetXY(newPos.x, newPos.y); } void OnTouchEnd(EventContext context) { _window.onTouchMove.Remove(OnTouchMove); _window.onTouchEnd.Remove(OnTouchEnd); } }

避坑提示：

• context.CaptureTouch()：在onTouchBegin中调用此方法至关重要，它能确保即使触摸点移出了当前组件范围，后续的onTouchMove和onTouchEnd事件依然能被该组件接收。没有这个，拖拽很容易中途失效。
• 边界计算基准：所有计算（鼠标偏移、窗口位置、边界）都应在同一个坐标系（这里是FairyGUI全局坐标）下进行，避免混合坐标系导致错乱。GRoot.inst.width/height是舞台的逻辑尺寸，用于边界判断非常合适。

4.2 场景二：UI组件跟随鼠标（如自定义光标、工具提示）

实现一个始终在鼠标位置的FairyGUI精灵。

public class MouseFollower : MonoBehaviour { public GObject follower; // 要跟随的FairyGUI对象 void Update() { if (follower == null || Stage.isTouchOnUI) // 如果触摸点在UI上，可以忽略 return; // 获取Unity屏幕坐标的鼠标位置 Vector3 mouseScreenPos = Input.mousePosition; // 转换为FairyGUI全局坐标（使用官方API以处理适配） Vector2 fairyGlobalPos = CoordinateTransformer.ScreenToFairyGlobal_Official(new Vector2(mouseScreenPos.x, mouseScreenPos.y)); // 设置跟随对象的位置。通常需要减去对象宽高的一半，让对象中心对准鼠标。 if (follower.parent != null) { Vector2 localPos = follower.parent.GlobalToLocal(fairyGlobalPos); follower.SetXY(localPos.x - follower.width / 2, localPos.y - follower.height / 2); } } }

注意事项：

• Stage.isTouchOnUI：这是一个非常有用的属性，当鼠标或触摸点正在点击一个FairyGUI对象时，它为true。这可以避免你的鼠标跟随器干扰正常的UI点击操作。
• 中心点对齐：直接设置位置会让对象的左上角对准鼠标。通过减去宽高的一半，可以实现中心点对齐，视觉效果更自然。

4.3 场景三：跨分辨率与多适配模式下的坐标稳定性

这是问题最多的领域。你的游戏可能需要在1920x1080、2340x1080、iPad等多种分辨率下运行，FairyGUI的GRoot也设置了不同的ScaleMode（如ScaleMode.ScaleWithScreenSize，ScaleMode.ConstantPhysicalSize等）。

核心原则：永远以GRoot.inst的逻辑尺寸为基准进行UI布局和坐标计算，而不是Screen.width/height。

错误示例：

// 假设设计分辨率是1920x1080 float screenX = Input.mousePosition.x; float designX = screenX * (1920f / Screen.width); // 这种计算在非设计分辨率下，且GRoot有缩放时，会出错。

正确做法：

1. 对于UI内部布局：使用FairyGUI的关联系统（如AddRelation）、锚点（pivot）和百分比布局。这是最稳定、最推荐的方式。
2. 对于需要手动计算的位置（如上述的拖拽边界、世界空间UI）：
   • 边界值使用GRoot.inst.width和GRoot.inst.height。
   • 坐标转换优先使用Stage.inst.camera和GRoot.inst.GlobalToLocal/LocalToGlobal这一套官方流程。
   • 如果必须用屏幕坐标，通过GRoot.inst的LocalToGlobal(Vector3.zero)先获取GRoot左上角对应的屏幕坐标，再结合GRoot的缩放因子进行计算。

一个通用缩放因子获取方法：

// 获取从FairyGUI逻辑坐标到实际屏幕像素的缩放比例 public Vector2 GetFairyToScreenScale() { // 方法1：通过GRoot的实际渲染尺寸与逻辑尺寸之比 // 注意：GRoot.inst.size 是逻辑尺寸，Stage.inst.size 是舞台实际像素尺寸？ // 更准确的是，FairyGUI内部有一个缩放因子。我们可以通过一个已知点来推算。 // 方法2（实用）：取一个逻辑点，看它转换到屏幕后的变化。 Vector2 fairyOrigin = Vector2.zero; Vector2 screenOrigin = CoordinateTransformer.FairyGlobalToScreen_Official(fairyOrigin); Vector2 fairyPoint = new Vector2(100, 100); Vector2 screenPoint = CoordinateTransformer.FairyGlobalToScreen_Official(fairyPoint); Vector2 scale = (screenPoint - screenOrigin) / 100f; return scale; }

5. 常见问题排查与调试技巧

即使理解了原理，实际开发中还是会遇到各种诡异的问题。这里我列一个排查清单和调试方法。

5.1 问题速查表

5.2 调试技巧：可视化坐标轴

在复杂问题定位时，光靠打印日志不够直观。我习惯在场景中创建几个临时的调试用FairyGUI图形来标记坐标。

public class CoordinateDebugger : MonoBehaviour { public GComponent debugRoot; private GGraph _crosshair; // 一个十字标记 void Start() { // 创建一个红色的十字线，用于标记鼠标位置 _crosshair = new GGraph(); _crosshair.DrawRect(20, 20, Color.red, Color.clear); _crosshair.pivot = new Vector2(0.5f, 0.5f); // 中心点对齐 debugRoot.AddChild(_crosshair); _crosshair.visible = false; // 监听全局触摸移动 Stage.inst.onTouchMove.Add(OnStageTouchMove); } void OnStageTouchMove(EventContext context) { InputEvent evt = context.inputEvent; Vector2 fairyPos = new Vector2(evt.x, evt.y); // 将十字标记移动到鼠标的FairyGUI全局坐标处 Vector2 localPos = debugRoot.GlobalToLocal(fairyPos); _crosshair.SetXY(localPos.x, localPos.y); _crosshair.visible = true; // 同时在Unity中画一个Debug射线（世界空间） Vector2 screenPos = CoordinateTransformer.FairyGlobalToScreen_Official(fairyPos); Ray ray = Camera.main.ScreenPointToRay(screenPos); Debug.DrawRay(ray.origin, ray.direction * 100, Color.green, 0.1f); // 打印坐标信息 Debug.Log($"FairyGUI全局: {fairyPos}, Unity屏幕: {screenPos}"); } }

通过这样一个简单的调试器，你可以清晰地看到鼠标位置在FairyGUI坐标系和Unity世界中的对应关系，对于验证转换公式的正确性有奇效。

坐标转换的本质是理解不同空间之间的映射关系。FairyGUI与Unity的协作，核心在于抓住GRoot这个枢纽。在绝大多数UI交互中，相信并利用好FairyGUI内置的事件坐标（它已经帮你做好了转换）。只有在需要与Unity原生3D世界或其他非FairyGUI系统交互时，才需要手动进行我们上面详细拆解的这些转换步骤。记住，保持所有计算在同一个坐标系内进行，并优先使用GRoot和Stage.camera提供的官方转换方法，是避免诡异Bug的最有效法则。