Unity新版本中ScreenToWorldPoint无法识别？求解决方案

我正在开发一款带射击机制的平台跳跃游戏，核心玩法包含围绕自身射击和鼠标瞄准。以下代码在Unity 2022.1.11f1中运行正常，但升级到2023.1.5f1后，编译器报错：

'Camera'不包含'ScreenToWorldPoint'的定义，也找不到接受类型为'Camera'的第一个参数的可访问扩展方法'ScreenToWorldPoint'（是否缺少using指令或程序集引用？）

搜索到的解决方案大多针对瞄准位置错误，而我的问题是编译器完全不识别该方法，求解决。

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

public class MoveFirePoint : MonoBehaviour
{

    private Camera mainCam;
    private Vector3 mousePos;

    // Start is called before the first frame update
    void Start()
    {
        mainCam = GameObject.FindGameObjectWithTag("MainCamera").GetComponent<Camera>();
    }

    // Update is called once per frame
    void Update()
    {
        //Follow mouse

        mousePos = mainCam.ScreenToWorldPoint(Input.mousePosition);

        Vector3 rotation = mousePos - transform.position;

        float rotZ = Mathf.Atan2(rotation.y, rotation.x) * Mathf.Rad2Deg;

        transform.rotation = Quaternion.Euler(0, 0, rotZ);

    }
}

解决方法 #

1. 排查命名冲突

如果项目中存在自定义的Camera脚本（同名类），编译器会优先引用自定义类而非Unity官方的UnityEngine.Camera，导致找不到方法。解决方式：

• 重命名自定义的Camera脚本，避免和Unity内置类同名；
• 或者在代码中使用完全限定名明确指定Unity的Camera类：

// 替换变量声明
private UnityEngine.Camera mainCam;

// Start方法中修改为
mainCam = GameObject.FindGameObjectWithTag("MainCamera").GetComponent<UnityEngine.Camera>();

2. 重新导入核心程序集

Unity版本升级后可能出现程序集引用异常，尝试重新导入所有资源：
在Unity编辑器顶部菜单点击 Assets -> Reimport All，等待资源重新加载完成后再编译代码。

3. 改用ScreenPointToRay实现瞄准（更可靠的替代方案）

ScreenToWorldPoint对z轴参数有依赖（透视相机需要指定距离），改用ScreenPointToRay可以避免这类问题，同时解决编译器报错：

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

public class MoveFirePoint : MonoBehaviour
{
    private UnityEngine.Camera mainCam;
    private Vector3 mousePos;

    void Start()
    {
        mainCam = GameObject.FindGameObjectWithTag("MainCamera").GetComponent<UnityEngine.Camera>();
    }

    void Update()
    {
        // 生成从相机到鼠标位置的射线
        Ray ray = mainCam.ScreenPointToRay(Input.mousePosition);
        // 创建一个平行于XY平面的检测平面（适配2D平台游戏）
        Plane targetPlane = new Plane(Vector3.forward, transform.position);

        // 计算射线与平面的交点
        if (targetPlane.Raycast(ray, out float distance))
        {
            mousePos = ray.GetPoint(distance);
        }

        Vector3 rotation = mousePos - transform.position;
        float rotZ = Mathf.Atan2(rotation.y, rotation.x) * Mathf.Rad2Deg;
        transform.rotation = Quaternion.Euler(0, 0, rotZ);
    }
}

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