Unity2D C#如何正确定义与使用RaycastHit射线检测变量

你在Unity2D环境下使用C#开发，首次接触射线检测，需要实现三个核心目标：

• 正确定义射线碰撞数据变量hitData
• 实现射线旋转效果，通过Debug.DrawRay完成可视化调试
• 获取碰撞数据中存储的碰撞距离、碰撞体标签等信息

原代码存在的核心错误 #

• Ray构造方法传参错误：标准Ray构造仅接收「原点坐标」「方向向量」两个参数，原代码多传入了无效的0参数
• 未执行实际的射线发射逻辑：仅声明RaycastHit类型变量不会自动填充碰撞数据，必须调用对应物理系统的Raycast方法发射射线，命中碰撞体后才会给hitData赋值
• 未做命中判断直接读取hitData属性：射线未命中任何碰撞体时直接读取distance、collider属性会触发空引用异常
• 旋转轴与方向适配错误：2D平面默认以Z轴为垂直深度轴，原代码绕Y轴旋转、用transform.forward做初始方向，会导致射线朝屏幕内部发射，无法和2D平面的碰撞体产生交互，也看不到旋转效果

修正后的可运行代码 #

以下代码适配Unity2D原生物理系统（使用Collider2D系列碰撞体组件）：

void Update()
{
    // 绕Z轴以100度/秒的速度旋转，适配2D平面视角
    Quaternion rotateQuaternion = Quaternion.AngleAxis(100 * Time.time, Vector3.forward);
    // 计算旋转后的射线方向，初始方向为物体自身右方向（2D下默认朝右，可按需替换为transform.up等方向）
    Vector3 rayDirection = rotateQuaternion * transform.right;
    // 射线检测最大距离
    float maxRayDistance = 20f;

    // 发射2D射线，直接返回填充好的碰撞数据
    RaycastHit2D hitData = Physics2D.Raycast(transform.position, rayDirection, maxRayDistance);

    // 分状态绘制调试射线
    if (hitData.collider != null)
    {
        // 命中碰撞体时，射线绘制到碰撞点位置，显示红色
        Debug.DrawRay(transform.position, rayDirection * hitData.distance, Color.red);
        // 读取碰撞数据
        float hitDistance = hitData.distance;
        string hitTargetTag = hitData.collider.tag;
        // 自定义命中逻辑写在这里，例如打印调试信息
        Debug.Log($"命中距离：{hitDistance}，命中对象标签：{hitTargetTag}");
    }
    else
    {
        // 未命中时，射线绘制到最大长度，显示绿色
        Debug.DrawRay(transform.position, rayDirection * maxRayDistance, Color.green);
    }
}

如果你在2D场景中混用了3D碰撞体（不带2D后缀的Collider组件），做以下替换即可：

1. 将RaycastHit2D hitData = Physics2D.Raycast(...)替换为RaycastHit hitData;
2. 射线发射逻辑改为bool isHit = Physics.Raycast(transform.position, rayDirection, out hitData, maxRayDistance);
3. 命中判断从hitData.collider != null改为判断isHit布尔值

关键实现要点 #

• 碰撞数据定义：2D物理系统中RaycastHit2D是值类型，调用Physics2D.Raycast会直接返回填充完成的碰撞数据；3D物理系统中需要用out关键字将hitData传入射线发射方法，才能拿到有效碰撞结果
• 旋转射线实现：通过Quaternion.AngleAxis逐帧根据运行时间计算旋转角度，乘以初始方向向量得到旋转后的射线方向；2D场景下旋转轴必须使用垂直于平面的Vector3.forward（Z轴），否则旋转效果不会在Scene视图显示
• 调试射线绘制：Debug.DrawRay的第二个参数需要传入「方向*长度」的实际绘制向量，根据命中状态切换颜色可以大幅提升调试效率
• 碰撞数据读取：必须先确认射线命中碰撞体，再读取距离、标签、碰撞体对象等信息，避免触发空引用报错

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