Unity C#赋值RectTransform位置时实际值与设置值不符问题

问题背景 #

• 实现目标：开发按下Tab键唤起的多队伍计分板，因队伍数量多设计为多分页结构，计分板预期效果如下：
  
• 对象层级：tab为承载所有计分板内容的根Canvas对象，计分板各分页均为Panel类型子对象。
• 问题触发：执行如下翻页位移代码时出现位置赋值不符合预期的问题：

tab_page = tab_page + value; // tab_page为当前所在页码，首页为0；value为翻页方向值，向前翻为-1，向后翻为1
Vector3 pos = new Vector3(tab_page * Screen.width, tab.transform.position.y, tab.transform.position.z);
Debug.Log(pos.x);
tab.transform.position = pos;

• 异常表现：日志打印的计算后pos.x值为1102，但RectTransform实际生效的位置x值仅为551或-551，异常表现如下：
  

问题根因 #

该异常由Unity UI Canvas缩放机制与坐标换算逻辑不匹配导致：
当Canvas的Render Mode为Screen Space - Camera/Screen Space - Overlay，且Canvas Scaler组件的UI Scale Mode设置为Scale With Screen Size时，transform.position返回的是经过Canvas缩放系数折算后的世界坐标，不是原生屏幕像素坐标。直接用Screen.width计算的偏移量会被缩放系数二次换算，就会出现计算值和实际生效值成比例偏差的情况——你遇到的1102变551，刚好是当前Canvas缩放系数为0.5导致的。

排查步骤 #

1. 选中计分板根Canvas，检查Canvas Scaler组件配置：
   • 确认UI Scale Mode选项，若为Scale With Screen Size，记录配置的参考分辨率数值
   • 运行时查看Canvas的scaleFactor属性值，若该值为0.5，可直接确认是缩放折算导致的数值偏差
2. 检查tab根对象的锚点（Anchor）配置，若锚点未对齐父节点左上角，也会出现固定偏移误差
3. 检查是否有其他脚本在LateUpdate等执行顺序更靠后的生命周期中修改tab位置，覆盖了当前代码的赋值结果

修复方案 #

推荐方案（适配所有Canvas缩放模式） #

直接操作RectTransform的锚点位置属性，该属性为UI元素基于锚点的本地坐标，不会被Canvas缩放系数额外折算，同时用单页自身宽度做偏移量，适配所有分辨率：

// 提前缓存组件，避免每次翻页重复获取
RectTransform tabRect = tab.GetComponent<RectTransform>();
int maxPage = 2; // 替换为实际的计分板总页数
// 加页码边界限制，防止翻页超出范围
tab_page = Mathf.Clamp(tab_page + value, 0, maxPage - 1);
// 单页宽度为分页Panel的实际UI宽度，比直接取Screen.width适配性更强
float pageWidth = tabRect.GetChild(0).GetComponent<RectTransform>().rect.width;
tabRect.anchoredPosition = new Vector2(-tab_page * pageWidth, tabRect.anchoredPosition.y);

临时适配方案（保留原有position赋值逻辑） #

如果需要保留原有transform.position的赋值方式，计算偏移时提前除以Canvas缩放系数，抵消二次折算影响：

Canvas rootCanvas = tab.GetComponentInParent<Canvas>();
tab_page = Mathf.Clamp(tab_page + value, 0, maxPage - 1);
float targetX = tab_page * Screen.width / rootCanvas.scaleFactor;
tab.transform.position = new Vector3(targetX, tab.transform.position.y, tab.transform.position.z);

内容的提问来源于stack exchange，提问作者Remy