Unity 2D中给位置属性赋值变量触发CS1612错误如何解决

问题复现 #

编写Boss AI关联的物体跟随逻辑时，尝试直接修改transform.position.x实现x轴偏移叠加，代码如下：

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class FistScript : MonoBehaviour
{
    public GameObject player;
    public float offset;
    // Start is called before the first frame update
    void Start()
    {
        
    }

    // Update is called once per frame
    void Update()
    {
        transform.position.x = new Vector2(player.transform.position.x + offset, transform.position.y);
    }
}

运行后控制台抛出报错：

Assets\Scripts\FistScript.cs(18,9): error CS1612: Cannot modify the return value of 'Transform.position' because it is not a variable

错误原因 #

Transform.position是值类型（Vector3结构体），访问该属性时返回的是当前位置的拷贝值，不是内存中位置变量的引用，直接修改拷贝值的单个分量没有实际意义，因此C#编译器直接拦截抛出CS1612错误。
另外原代码用Vector2给3D坐标属性赋值会丢失z轴数据，3D场景下可能出现坐标异常。

修复方案 #

不要单独修改position的单个分量，而是构造完整的位置向量，整体赋值给transform.position属性，修正后代码如下：

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class FistScript : MonoBehaviour
{
    public GameObject player;
    public float offset;
    
    void Update()
    {
        // 构造新的三维位置向量，整体赋值
        transform.position = new Vector3(
            player.transform.position.x + offset,
            transform.position.y,
            transform.position.z
        );
    }
}

如果习惯分步修改坐标，也可以用临时变量中转的写法，效果一致：

void Update()
{
    // 先把当前位置存到值类型临时变量
    Vector3 targetPos = transform.position;
    // 修改临时变量的对应分量
    targetPos.x = player.transform.position.x + offset;
    // 把修改完成的坐标整体赋值回去
    transform.position = targetPos;
}

通用注意事项 #

• Unity中所有返回值类型的属性都遵循这个规则，包括但不限于Transform.localPosition、RectTransform.anchoredPosition、Renderer.bounds、Material.color，都不能直接修改返回值的单个分量，必须整体赋值
• 处理3D物体坐标时优先使用Vector3，避免Vector2隐式转换导致的z轴数据丢失问题

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