1. 项目概述：为什么FairyGUI坐标转换是个“坑”？

如果你在Unity项目里用过FairyGUI，并且尝试过把UI元素的位置、尺寸或者交互区域映射到3D世界或者其他UI系统里，那你大概率已经和“坐标转换”这个老朋友打过照面了。这个看似基础的操作，在实际开发中却是一个高频的“坑点”聚集地。我接手过不少项目，发现很多团队在UI与游戏逻辑的交互上，尤其是点击检测、特效挂载、3D UI混合这些场景，都会因为坐标转换没处理好，导致UI错位、点击无效、特效飞天等诡异问题。很多时候，问题不是出在FairyGUI本身，而是开发者对Unity和FairyGUI两套坐标系、锚点、容器关系的理解不够透彻。

FairyGUI作为一个强大的UI编辑器，它有自己的坐标空间和渲染逻辑。当我们需要把FairyGUI中一个按钮的坐标，转换成Unity世界空间中的一个点，用来发射射线检测，或者把一个3D模型精准地“贴”在某个UI元件后面时，坐标转换就成了必经之路。这个过程涉及到从FairyGUI的本地坐标，到UI根容器的全局坐标，再到Unity屏幕坐标，最后到世界坐标或另一个UI系统坐标的多重变换。任何一个环节的疏忽，比如忽略了容器的缩放、旋转，或者没搞清GlobalToLocal和LocalToGlobal的区别，都会让最终结果差之千里。

这篇文章，我就结合自己趟过的坑，把FairyGUI坐标转换的核心原理、常见场景的完整实现方案，以及那些文档里不会写的调试技巧，给你一次性讲清楚。无论你是刚接触FairyGUI的新手，还是已经用过一阵但总被坐标问题困扰的开发者，这篇指南都能帮你建立起清晰的认知，并提供可以直接“抄作业”的代码。

2. 核心原理拆解：两套坐标系与转换链条

要避坑，先得明白“坑”从哪来。FairyGUI的坐标转换之所以复杂，根源在于它和Unity是两套独立但又需要频繁通信的体系。

2.1 FairyGUI坐标系：基于编辑器的逻辑空间

在FairyGUI编辑器中，你摆放组件时所处的那个二维平面，就是FairyGUI的原始坐标空间。它的原点(0,0)通常位于组件或其父容器的左上角（取决于坐标类型），X轴向右，Y轴向下。这是一个纯粹的“逻辑像素”空间，和你编辑器里设置的UI设计分辨率（比如1920x1080）直接相关。

这里有几个关键对象需要理解：

• GObject：所有UI元件（按钮、图片、列表等）的基类。它有一个xy属性（Vector2），表示其在直接父容器中的位置。这是最基础的“本地坐标”。
• GComponent：容器组件，它本身也是一个GObject，但内部可以包含其他GObject。容器会影响其内部所有子元件的坐标计算。
• GRoot：整个UI的根容器，是所有UI的最终父节点。它负责处理UI与屏幕的适配（如缩放模式）。

当一个按钮位于一个面板内，面板又位于根容器下时，按钮的xy是相对于面板的。要得到它在整个UI界面中的位置，就需要进行坐标转换。

2.2 Unity坐标系：屏幕、视口与世界

Unity的坐标系大家相对熟悉，但为了转换，我们必须明确几个空间：

1. 屏幕空间（Screen Space）：以像素为单位，原点在屏幕左下角，X向右，Y向上。Input.mousePosition返回的就是这个空间的坐标。
2. 视口空间（Viewport Space）：归一化的屏幕空间，原点在左下角，范围从(0,0)到(1,1)。常用于一些图形计算。
3. 世界空间（World Space）：3D场景的全局坐标系，单位是Unity单位（米）。
4. UI（Canvas）空间：如果使用uGUI，其RectTransform在Canvas下也有自己的局部和全局坐标。

FairyGUI最终是通过一个或多个“UIPanel”或“Stage Camera”渲染到Unity场景中的。这个渲染过程，本质上是将FairyGUI的逻辑坐标空间，经过缩放、偏移，映射到Unity的屏幕空间或世界空间的一个平面上。

2.3 转换的核心链条与关键API

坐标转换不是一步到位的，而是一个链条。最典型的链条是：FairyGUI本地坐标 -> FairyGUI全局坐标 -> Unity屏幕坐标 -> Unity世界坐标。

FairyGUI SDK提供了最关键的几个API来完成在其自身体系内的转换：

• LocalToGlobal(Vector2 localPoint)：将一个点从当前元件的本地坐标系转换到UI根（GRoot）的坐标系。这里的“本地”是相对于调用该方法的元件自身的原点。
• GlobalToLocal(Vector2 globalPoint)：将一个点从UI根（GRoot）的坐标系转换到当前元件的本地坐标系。
• TransformPoint(Vector2 point, GObject fromObj, GObject toObj)：更通用的方法，将一个点从一个元件的坐标系转换到另一个元件的坐标系。

关键理解：LocalToGlobal中的“Local”指的是“调用者自身的坐标系原点”，而不是其父容器的坐标系。这是新手最容易混淆的地方。比如，一个按钮在面板(100,100)的位置，面板自身在(50,50)。按钮的xy是(100,100)。对按钮调用LocalToGlobal(Vector2.zero)，得到的是按钮自身原点（即其左上角）在GRoot中的坐标，这个结果已经包含了面板位置(50,50)的影响。如果你传入的是(100,100)，那计算的就是按钮内部(100,100)这个点在GRoot中的位置，这通常就超出了按钮可视范围了。

要将FairyGUI坐标转到Unity空间，我们通常先得到在GRoot中的坐标（即全局坐标），然后利用GRoot的GetScaleFactor()、GetScreenSize()以及UIPanel或StageCamera的信息，将其换算到Unity屏幕坐标。

3. 实战场景与完整代码示例

理论说再多，不如看代码。下面我针对几个最常见的开发场景，给出详细的代码实现和解释。

3.1 场景一：将FairyGUI元件位置映射到3D世界

这是一个经典需求，比如你需要在一个UI图标的位置上，实例化一个3D特效，或者让一个3D角色走到UI所指示的屏幕位置对应的世界坐标。

思路：

1. 获取UI元件（如一个按钮）在FairyGUI全局空间中的位置（通常是其中心点或某个顶点）。
2. 将这个全局坐标转换为Unity的屏幕坐标。
3. 利用Camera.main.ScreenToWorldPoint将屏幕坐标转换为世界坐标。注意，对于透视相机，你需要指定一个Z值（通常是从相机到目标平面的距离）；对于正交相机，Z值影响不大但也要合理设置。

using UnityEngine; using FairyGUI; public class UIWorldPositionHelper : MonoBehaviour { // 假设我们有一个在FairyGUI中名为`btnTarget`的按钮 public GComponent uiView; // 你的FairyGUI界面组件 private GObject _targetBtn; // 用于计算世界坐标的摄像机，默认为主摄像机 public Camera worldCamera; // 对于透视相机，这个距离表示从相机到你想放置物体的“平面”的距离 public float distanceFromCamera = 10f; void Start() { if (worldCamera == null) worldCamera = Camera.main; _targetBtn = uiView.GetChild("btnTarget"); if (_targetBtn == null) { Debug.LogError("未找到名为'btnTarget'的UI元件！"); return; } // 示例：在UI按钮的中心点位置创建一个3D立方体 Vector3 worldPos = GetUIObjectWorldPosition(_targetBtn); GameObject cube = GameObject.CreatePrimitive(PrimitiveType.Cube); cube.transform.position = worldPos; cube.transform.localScale = Vector3.one * 0.5f; } /// <summary> /// 计算一个FairyGUI对象中心点对应的世界坐标 /// </summary> /// <param name="obj">FairyGUI对象</param> /// <returns>世界坐标</returns> public Vector3 GetUIObjectWorldPosition(GObject obj) { // 1. 获取对象在其自身坐标系中的范围（以左上角为原点） Rect rect = obj.rect; // 计算中心点在自身坐标系中的位置 Vector2 localCenter = new Vector2(rect.width * 0.5f, rect.height * 0.5f); // 2. 将中心点坐标转换到FairyGUI全局坐标（GRoot空间） Vector2 globalCenter = obj.LocalToGlobal(localCenter); // 3. 将FairyGUI全局坐标转换到Unity屏幕坐标 // 注意：GRoot的全局坐标原点在左上角，Y轴向下。 // Unity屏幕坐标原点在左下角，Y轴向上。需要进行Y轴翻转。 Vector2 screenSize = GRoot.inst.GetScreenSize(); Vector2 unityScreenPos = new Vector2( globalCenter.x, screenSize.y - globalCenter.y // Y轴翻转 ); // 4. 将屏幕坐标转换到世界坐标 // 对于透视投影，ScreenToWorldPoint需要指定一个在相机视线方向上的深度值（Z值）。 // 这里我们使用一个预设的距离。更复杂的场景可能需要射线碰撞来确定深度。 Vector3 screenPosWithDepth = new Vector3(unityScreenPos.x, unityScreenPos.y, distanceFromCamera); Vector3 worldPosition = worldCamera.ScreenToWorldPoint(screenPosWithDepth); return worldPosition; } }

注意事项与避坑点：

• Y轴翻转：这是最容易遗漏的一步！FairyGUI全局坐标的Y轴向下为正，而Unity屏幕坐标Y轴向上为正。转换时必须用屏幕高度 - FairyGUI全局坐标Y。
• 屏幕适配：GRoot.inst.GetScreenSize()返回的是经过FairyGUI适配策略（如缩放模式）后的逻辑屏幕尺寸，可能与Unity的Screen.width/height不同。在坐标转换时，应始终使用FairyGUI提供的屏幕尺寸，以保证一致性。
• 深度（Z值）问题：ScreenToWorldPoint的Z值含义取决于相机类型。对于透视相机，它代表从相机近裁剪平面沿视线方向的距离。你需要根据你的游戏场景合理设定这个值，或者通过从相机发射射线到某个世界平面（如地面）来动态计算。
• 容器变换的影响：如果目标UI元件在一个有旋转或缩放的容器内，LocalToGlobal方法已经自动处理了这些变换。但如果你需要更精确的控制（比如获取元件的四个角点），可能需要分别转换每个顶点。

3.2 场景二：响应3D世界点击，判断是否点中FairyGUI元件（射线检测）

另一种常见场景是，在3D游戏中有UI覆盖，你需要判断玩家的点击或触摸是落在了3D物体上，还是落在了某个FairyGUI UI元件上，或者需要忽略UI的点击穿透。

思路：

1. 获取Unity的输入屏幕坐标（Input.mousePosition或触摸位置）。
2. 将其转换为FairyGUI的全局坐标（需要反向进行Y轴翻转和屏幕尺寸换算）。
3. 使用FairyGUI提供的HitTest方法或GRoot.inst.touchTarget来判断点击到了哪个UI元件。

using UnityEngine; using FairyGUI; public class UIClickDetection : MonoBehaviour { public GComponent uiView; void Update() { if (Input.GetMouseButtonDown(0)) { ProcessClick(Input.mousePosition); } // 移动端类似，使用Touch.position } void ProcessClick(Vector2 unityScreenPos) { // 1. 将Unity屏幕坐标转换为FairyGUI全局坐标 Vector2 fguiGlobalPos = ConvertToFairyGlobalPos(unityScreenPos); // 方法A：使用GRoot的HitTest进行精确检测 GObject hitObject = GRoot.inst.HitTest(fguiGlobalPos); if (hitObject != null) { Debug.Log($"点击到了FairyGUI对象：{hitObject.name}"); // 可以进一步判断是否是你关心的特定对象 if (hitObject == uiView.GetChild("specificBtn")) { // 处理特定按钮点击逻辑 OnSpecificButtonClicked(); } // 如果点击到了UI，可以选择阻止对3D物体的射线检测 // return; } // 方法B：直接检查当前触摸目标（更轻量，适用于简单判断） // if (GRoot.inst.touchTarget != null) // { // Debug.Log("当前触摸在UI上"); // } // 如果未点击到UI，继续执行3D世界的射线检测... if (hitObject == null) { Perform3DRaycast(unityScreenPos); } } /// <summary> /// 将Unity屏幕坐标转换为FairyGUI全局坐标 /// </summary> private Vector2 ConvertToFairyGlobalPos(Vector2 unityScreenPos) { Vector2 screenSize = GRoot.inst.GetScreenSize(); // 反向Y轴翻转： unityScreenPos.y是左下角为原点向上，FairyGUI需要左上角为原点向下。 // 所以： fguiY = screenSize.y - unityScreenPos.y; // 注意：Input.mousePosition的(0,0)是屏幕左下角。 return new Vector2( unityScreenPos.x, screenSize.y - unityScreenPos.y ); } private void Perform3DRaycast(Vector2 screenPos) { Ray ray = Camera.main.ScreenPointToRay(screenPos); RaycastHit hit; if (Physics.Raycast(ray, out hit)) { Debug.Log($"点击到了3D物体：{hit.collider.gameObject.name}"); } } private void OnSpecificButtonClicked() { // 你的按钮点击逻辑 Debug.Log("特定按钮被点击！"); } }

避坑指南：

• 事件冒泡与穿透：FairyGUI的HitTest会考虑元件的触摸启用状态（touchable）和透明度点击测试（opaque）。如果一个元件touchable为false或其opaque为true且点击处像素完全透明，则点击会穿透到下层。理解这个机制对于设计复杂的UI交互层叠很重要。
• 多摄像机情况：如果你的场景有多个摄像机（比如一个用于UI的Orthographic相机和一个用于3D世界的Perspective相机），需要确保ConvertToFairyGlobalPos中使用的屏幕尺寸与渲染FairyGUI的那个相机（通常是Stage Camera）的渲染视口匹配。在复杂渲染管线中，可能需要手动指定相机。
• 性能考量：GRoot.inst.HitTest会遍历UI树进行计算。在每帧都需要检测的场合（如拖拽），要关注性能。如果UI结构复杂，可以考虑缓存需要检测的元件列表，或者使用更粗略的矩形包围盒检测进行初步筛选。

3.3 场景三：FairyGUI与Unity uGUI系统的坐标互通

有些项目会混合使用FairyGUI和Unity原生的uGUI。例如，用FairyGUI做复杂的动态UI，用uGUI做简单的静态HUD。这时就需要在两个系统间传递坐标。

思路：

1. FairyGUI -> uGUI：先将FairyGUI坐标转到Unity屏幕坐标，然后使用RectTransformUtility.ScreenPointToLocalPointInRectangle将其转换到目标uGUI Canvas下的局部坐标。
2. uGUI -> FairyGUI：先将uGUI RectTransform的局部坐标通过RectTransformUtility.WorldToScreenPoint转到屏幕坐标，再按场景二的方法转到FairyGUI全局坐标。

using UnityEngine; using UnityEngine.UI; using FairyGUI; public class CoordinateBridge : MonoBehaviour { public GComponent fairyUIView; // FairyGUI组件 public RectTransform uguiTargetRect; // 一个uGUI的RectTransform，例如一个Image /// <summary> /// 将FairyGUI对象的位置同步到一个uGUI RectTransform的中心 /// </summary> public void SyncFairyToUGUI(GObject fairyObj) { // 1. 获取FairyGUI对象的中心点在Unity屏幕坐标 Vector2 fairyGlobalCenter = fairyObj.LocalToGlobal(new Vector2(fairyObj.width * 0.5f, fairyObj.height * 0.5f)); Vector2 screenSize = GRoot.inst.GetScreenSize(); Vector2 unityScreenPos = new Vector2(fairyGlobalCenter.x, screenSize.y - fairyGlobalCenter.y); // 2. 将屏幕坐标转换到uGUI Canvas下的局部坐标 Canvas canvas = uguiTargetRect.GetComponentInParent<Canvas>(); if (canvas != null) { Vector2 localPos; RectTransformUtility.ScreenPointToLocalPointInRectangle( uguiTargetRect.parent as RectTransform, // 通常传入父级RectTransform unityScreenPos, canvas.worldCamera, // 如果Canvas是Screen Space - Camera模式，需要传相机 out localPos ); uguiTargetRect.localPosition = localPos; } } /// <summary> /// 将uGUI RectTransform的位置同步到FairyGUI对象 /// </summary> public void SyncUGUIToFairy(RectTransform uguiRect, GObject fairyObj) { // 1. 获取uGUI对象的中心点在Unity屏幕坐标 Canvas canvas = uguiRect.GetComponentInParent<Canvas>(); Vector3[] worldCorners = new Vector3[4]; uguiRect.GetWorldCorners(worldCorners); Vector3 worldCenter = (worldCorners[0] + worldCorners[2]) * 0.5f; // 计算世界空间中心 Camera screenCamera = canvas.renderMode == RenderMode.ScreenSpaceOverlay ? null : canvas.worldCamera; Vector2 unityScreenPos = RectTransformUtility.WorldToScreenPoint(screenCamera, worldCenter); // 2. 将Unity屏幕坐标转换为FairyGUI全局坐标 Vector2 fguiGlobalPos = new Vector2( unityScreenPos.x, GRoot.inst.GetScreenSize().y - unityScreenPos.y ); // 3. 将FairyGUI全局坐标转换到目标对象的本地坐标 Vector2 localPosInFairy = fairyObj.GlobalToLocal(fguiGlobalPos); // 你可以用这个localPos来设置fairyObj的位置，或者进行其他逻辑 Debug.Log($"对应的FairyGUI本地坐标：{localPosInFairy}"); } }

关键点解析：

• Canvas渲染模式：RectTransformUtility.ScreenPointToLocalPointInRectangle的第三个参数（camera）至关重要。对于Screen Space - Overlay模式的Canvas，传入null；对于Screen Space - Camera或World Space模式，需要传入对应的渲染相机。
• 坐标空间一致性：确保在转换链条中，你始终清楚当前坐标处于哪个空间（FairyGUI全局、Unity屏幕、uGUI局部世界等），并正确地进行翻转和缩放计算。
• 锚点影响：uGUI的RectTransform位置受锚点（Anchors）和轴心点（Pivot）影响极大。上述示例假设你将uGUI元素的位置直接设置为其局部位置。在实际应用中，你可能需要根据轴心点对计算出的位置进行微调。

4. 深度避坑：那些文档里不会告诉你的细节

掌握了基本场景的代码后，我们再来深挖几个容易导致诡异问题的细节。这些经验大多来自实际项目的调试过程。

4.1 容器缩放、旋转与轴心点的影响

FairyGUI的容器（GComponent）支持缩放（scaleX, scaleY）和旋转（rotation）。当你对一个容器进行这些变换时，其内部所有子元件的LocalToGlobal和GlobalToLocal计算会自动包含这些变换矩阵。

问题：当你需要获取一个子元件变换后的实际包围盒（用于和3D碰撞盒对齐等），直接使用obj.rect（它存储的是原始设计尺寸和本地位置）就不准确了。

解决方案：使用obj.TransformRect方法（如果SDK版本提供），或者手动计算。更通用的方法是获取元件四个顶点的全局坐标。

// 获取一个GObject变换后的四个角点的全局坐标（考虑父容器的缩放旋转） public Vector2[] GetTransformedCorners(GObject obj) { Rect rect = obj.rect; Vector2[] localCorners = new Vector2[] { new Vector2(0, 0), // 左上 new Vector2(rect.width, 0), // 右上 new Vector2(rect.width, rect.height), // 右下 new Vector2(0, rect.height) // 左下 }; Vector2[] globalCorners = new Vector2[4]; for (int i = 0; i < 4; i++) { globalCorners[i] = obj.LocalToGlobal(localCorners[i]); } return globalCorners; }

轴心点（Pivot）：FairyGUI的元件也有轴心点，它影响元件的旋转和缩放中心。但坐标转换API（LocalToGlobal）是基于元件自身的坐标系原点的，这个原点就是其左上角（不考虑轴心点）。轴心点主要影响的是xy属性的参考点以及显示变换。在计算顶点时，我们通常关心的是包围盒的角点，所以上述按左上角原点计算的方法是通用的。

4.2 滚动容器（ScrollPane）内的坐标转换

滚动容器是另一个大坑。容器内的内容区域（content）可能发生了滚动偏移（posX,posY）。

关键点：content也是一个GObject。对content内的子元件调用LocalToGlobal时，计算出的坐标已经包含了滚动偏移。因为LocalToGlobal是从该子元件一直向上遍历到GRoot，中间会经过content，而content的x和y就是滚动偏移值。

常见错误：试图手动加上scrollPane.posX来修正坐标，结果导致双倍偏移。

正确做法：直接对滚动容器内的子元件使用其LocalToGlobal方法即可，FairyGUI已经处理好了。如果你需要获取子元件相对于滚动容器**视口（viewport）**的位置，才需要用到滚动位置。

// 获取滚动容器内一个item相对于滚动容器视口左上角的位置 GList list = scrollPane.GetComponent<GList>(); GObject item = list.GetChildAt(0); // 错误：itemGlobalPos = item.LocalToGlobal(Vector2.zero) + new Vector2(scrollPane.posX, scrollPane.posY); // 正确：以下得到的已经是包含滚动偏移的全局坐标 Vector2 itemGlobalPos = item.LocalToGlobal(Vector2.zero); // 如果需要相对于视口的位置： Vector2 viewportLocalPos = item.GlobalToLocal(scrollPane.content.LocalToGlobal(new Vector2(-scrollPane.posX, -scrollPane.posY))); // 这行代码有点绕，解释一下： // 1. scrollPane.content.LocalToGlobal(Vector2.zero) 得到content原点在全局的位置。 // 2. 视口的全局位置，可以认为是 content的全局位置 减去 滚动偏移(scrollPane.posX, posY)。因为滚动是内容在动，视口不动。 // 3. 将视口的全局坐标用 item.GlobalToLocal 转换，就得到了item相对于视口左上角的位置。 // 实际上，对于判断item是否在视口内，通常有更简单的方法，比如检查item的全局坐标范围是否与视口的全局坐标范围相交。

4.3 动态分辨率适配与缩放因子

现代游戏需要适配各种屏幕比例和分辨率。FairyGUI通过GRoot的“缩放模式”（如ScaleMode.ScaleWithScreenSize）来处理。这会导致FairyGUI的“逻辑像素”与Unity“屏幕像素”之间有一个缩放因子。

核心API：GRoot.inst.GetScaleFactor()。这个值表示：1个FairyGUI逻辑像素对应多少个Unity屏幕像素。

影响：当你进行坐标转换时，如果涉及像素级别的精确对齐（例如，将FairyGUI的边界与一个精确的屏幕像素网格对齐），你必须考虑这个缩放因子。LocalToGlobal返回的坐标是逻辑像素，而Unity的Screen.width/height和Input.mousePosition是物理屏幕像素。

在之前场景一的代码中，我们使用GRoot.inst.GetScreenSize()来获取逻辑屏幕尺寸，这已经考虑了缩放模式。所以公式unityScreenPos.y = screenSize.y - globalCenter.y是正确的。如果你错误地使用了Screen.height，在缩放模式不是ScaleMode.ConstantPixelSize时就会出错。

// 正确：使用FairyGUI提供的逻辑屏幕尺寸 Vector2 screenSize = GRoot.inst.GetScreenSize(); // 例如 (1920, 1080) 逻辑像素 Vector2 unityScreenPos = new Vector2(globalCenter.x, screenSize.y - globalCenter.y); // 错误：在非1:1缩放时，直接使用物理像素尺寸 // Vector2 unityScreenPos = new Vector2(globalCenter.x, Screen.height - globalCenter.y);

4.4 渲染层级（RenderOrder）与多摄像机

如果你的项目使用了多个摄像机分层渲染（比如一个摄像机渲染3D场景，另一个摄像机渲染UI），并且FairyGUI的Stage Camera可能与主摄像机不同，那么坐标转换就需要指定正确的摄像机。

关键：Camera.ScreenToWorldPoint和RectTransformUtility的相关方法都需要传入一个Camera参数。这个相机应该是将你关心的那个空间渲染到屏幕的相机。

• 对于FairyGUI，它通常由一个专门的“Stage Camera”渲染（如果你使用了UIPanel且设置为Render Mode = Screen Space Camera）。
• 对于3D物体，通常由Camera.main或你的场景主相机渲染。
• 对于uGUI，由其所在Canvas的worldCamera指定。

在转换坐标时，务必使用目标对象所对应的渲染相机。例如，将FairyGUI坐标转换到3D世界坐标，用于在主相机下创建特效，那么ScreenToWorldPoint就应该使用主相机，而不是Stage Camera。但之前获取的unityScreenPos是基于整个屏幕空间的，这是统一的。

5. 调试技巧与问题排查实录

当坐标转换出现问题时，不要盲目猜测。系统化的调试能帮你快速定位。

5.1 可视化调试工具

在代码中临时绘制调试信息是最直接的方法。

void DebugDrawUIBoundary(GObject obj, Color color) { Vector2[] corners = GetTransformedCorners(obj); // 使用前面定义的方法 Vector2 screenPos0 = ConvertFairyGlobalToUnityScreen(corners[0]); Vector2 screenPos1 = ConvertFairyGlobalToUnityScreen(corners[1]); Vector2 screenPos2 = ConvertFairyGlobalToUnityScreen(corners[2]); Vector2 screenPos3 = ConvertFairyGlobalToUnityScreen(corners[3]); // 使用Debug.DrawLine在Scene视图中绘制（需要世界坐标） // 但Debug.DrawLine是3D的，我们可以用GUI或Gizmos在屏幕空间画，这里提供一个思路： // 将屏幕坐标转换为位于固定深度的世界坐标来画线 float debugDepth = 10f; Vector3 worldPos0 = Camera.main.ScreenToWorldPoint(new Vector3(screenPos0.x, screenPos0.y, debugDepth)); Vector3 worldPos1 = Camera.main.ScreenToWorldPoint(new Vector3(screenPos1.x, screenPos1.y, debugDepth)); // ... 同理得到其他点 Debug.DrawLine(worldPos0, worldPos1, color); Debug.DrawLine(worldPos1, worldPos2, color); Debug.DrawLine(worldPos2, worldPos3, color); Debug.DrawLine(worldPos3, worldPos0, color); } private Vector2 ConvertFairyGlobalToUnityScreen(Vector2 fairyGlobalPos) { Vector2 screenSize = GRoot.inst.GetScreenSize(); return new Vector2(fairyGlobalPos.x, screenSize.y - fairyGlobalPos.y); }

更简单的方法是，在Update里打印关键坐标：

void Update() { if (Input.GetMouseButton(0)) { Vector2 mousePos = Input.mousePosition; Vector2 fguiPos = ConvertToFairyGlobalPos(mousePos); GObject hitObj = GRoot.inst.HitTest(fguiPos); Debug.Log($"Mouse: {mousePos}, FairyGUI Global: {fguiPos}, Hit: {(hitObj != null ? hitObj.name : "null")}"); } }

5.2 常见问题速查表

5.3 一个综合排查案例

曾经遇到一个Bug：在平板设备上，某个弹出窗口的关闭按钮点击区域比视觉区域偏右下角。

1. 第一步：确认问题。在PC编辑器上模拟平板分辨率，用调试代码绘制按钮边界，发现边界框确实偏右下。
2. 第二步：检查基础转换。打印按钮的rect、LocalToGlobal(Vector2.zero)的坐标，发现LocalToGlobal的结果与预期相符。
3. 第三步：检查屏幕坐标转换。将LocalToGlobal的结果转换为Unity屏幕坐标并打印，同时打印Input.mousePosition。对比发现，转换后的Y坐标比鼠标实际的Y坐标小了一个固定值。
4. 第四步：定位差异。这个固定值恰好等于(Screen.height - GRoot.inst.GetScreenSize().y)。原来，项目设置中FairyGUI的设计分辨率是1920x1080，但平板模拟的分辨率是2048x1536。FairyGUI的缩放模式是ScaleMode.ScaleWithScreenSize，并设置了“仅缩放宽度”的适配策略。这导致逻辑屏幕高度（GRoot.inst.GetScreenSize().y）仍然是1080，而物理屏幕高度（Screen.height）是1536。在转换函数中，我错误地使用了Screen.height进行Y轴翻转。
5. 第五步：修复。将转换函数中的Screen.height替换为GRoot.inst.GetScreenSize().y，问题解决。

这个案例的教训是：永远使用FairyGUI提供的GRoot.inst.GetScreenSize()来进行与FairyGUI坐标相关的屏幕空间计算，不要直接使用Unity的Screen类，除非你非常清楚两者在当前适配策略下是一致的。

坐标转换就像一座连接FairyGUI岛屿和Unity大陆的桥梁，理解每一段桥墩（坐标空间）和连接处（转换API）的作用，才能让数据在这两个世界间准确无误地通行。希望这篇指南和这些代码示例，能帮你填平开发路上的这些“坑”。