Physics2D.Linecast与Debug.DrawLine结果异常问题排查及解决

问题描述 #

我在使用Unity的Physics2D.Linecast和Debug.DrawLine实现“向鼠标方向延长线发射射线检测碰撞”的功能时，遇到了结果异常的情况。初始代码如下：

Vector2 curMousePosition = Camera.main.ScreenToWorldPoint(Input.mousePosition);
Vector2 mouseDir = curMousePosition * 10.0f;
RaycastHit2D hit = Physics2D.Linecast(player.transform.position, mouseDir);
if (hit.collider != null) {
    Debug.Log("cur mouse point = " + curMousePosition);
    Debug.Log("mouse dir point = " + mouseDir);
    Debug.Log("hit point = " + hit.point);
    Debug.DrawLine(player.transform.position, curMousePosition, Color.red);
    Debug.DrawLine(player.transform.position, mouseDir, Color.yellow);
    Debug.DrawLine(player.transform.position, hit.point, Color.blue);
}

我原本的意图是：从玩家位置出发，向鼠标坐标相对于玩家的方向延长10倍的位置发射射线，获取延长线上的碰撞体坐标。但运行后发现，mouseDir（鼠标坐标×10）和hit.point的结果完全不符合预期。我以为Linecast是检测两点之间线段上的碰撞，是不是我对这个API的理解有误区？

问题根源：向量计算逻辑错误 #

其实你对Physics2D.Linecast的理解是对的——它确实是检测两点之间线段上的碰撞，但问题出在延长线的向量计算上：

你的初始代码中mouseDir = curMousePosition * 10.0f，这是直接把鼠标的世界坐标放大10倍，而不是基于玩家位置的方向延长。比如如果鼠标在世界坐标(1,1)，乘以10后得到(10,10)，但如果玩家在(5,5)，这条射线的方向就不是从玩家指向鼠标的延长线，而是从(5,5)指向(10,10)，这和你想要的“从玩家出发沿鼠标方向延长”完全不是一回事。

修正后的解决方案 #

通过重新梳理向量计算逻辑，先计算玩家到鼠标的相对方向，再基于这个方向生成延长线的终点，就能得到正确的射线碰撞结果。修正后的代码如下：

Vector2 playerPos = player.transform.position;
Vector2 curMousePosition = Camera.main.ScreenToWorldPoint(Input.mousePosition);
Vector2 relativePos = curMousePosition - playerPos;
float mouseAngle = Mathf.Atan2(relativePos.x, relativePos.y) * Mathf.Rad2Deg;
Quaternion rot = Quaternion.Euler(0f, 0f, -mouseAngle);
Vector2 rVec = rot * Vector2.up * 20.0f;
Vector2 mouseDir = playerPos + rVec;
RaycastHit2D hit = Physics2D.Linecast(player.transform.position, mouseDir);
if (hit.collider != null) {
    Debug.DrawLine(player.transform.position, mouseDir, Color.yellow);
    Debug.DrawLine(player.transform.position, hit.point, Color.blue);
    Debug.DrawLine(player.transform.position, curMousePosition, Color.red);
}

简单解释下修正的核心逻辑：

• 先计算玩家到鼠标的相对位置relativePos，这是从玩家指向鼠标的方向向量
• 通过Atan2计算这个方向的角度，再生成对应的旋转四元数
• 基于旋转后的方向向量（Vector2.up旋转后指向鼠标方向），乘以延长倍数（20.0f）得到延长的向量长度
• 最后把延长后的向量加到玩家位置上，得到射线的终点mouseDir，这样射线就是从玩家出发，沿鼠标方向延长的线段了

内容的提问来源于stack exchange，提问作者Seung il Park