Unity中OverlapCircle半径检测异常问题求助

问题根源 #

你的问题出在圆形检测与Tilemap网格碰撞体的匹配度上：

• Tilemap默认瓦片碰撞体是1x1单位的矩形，覆盖整个网格单元格，范围是(x±0.5, y±0.5)（x、y为网格中心整数坐标）。
• 当检测半径小于0.5f时，若检测点不是严格的网格中心，圆形范围可能无法覆盖碰撞体区域，导致漏检墙体。
• 半径设为0.5f时，圆形范围刚好覆盖整个网格，但如果检测点偏移（比如movePoint不在网格中心），圆会延伸到相邻网格，误触发相邻墙体的检测。

解决办法 #

1. 改用更适合网格的检测方式（推荐）

放弃OverlapCircle，改用OverlapBox或OverlapPoint，这两种方式更适配Tilemap的矩形网格特性：

方式一：使用OverlapBox精准检测网格

if (Mathf.Abs(Input.GetAxisRaw("Horizontal")) == 1f)
{
    // 计算目标位置
    Vector3 targetPos = movePoint.position + new Vector3(Input.GetAxisRaw("Horizontal"), 0, 0);
    // 将目标位置对齐到网格中心（确保检测点在网格正中间）
    targetPos = new Vector3(Mathf.Round(targetPos.x), Mathf.Round(targetPos.y), targetPos.z);
    // 用略小于1x1的盒子检测，避免误触相邻网格
    if (!Physics2D.OverlapBox(targetPos, new Vector2(0.9f, 0.9f), 0f, moveBlockers))
    {
        movePoint.position += new Vector3(Input.GetAxisRaw("Horizontal"), 0, 0);
    }
}

方式二：使用OverlapPoint检测网格中心

如果你的Tilemap碰撞体完整覆盖网格，直接检测网格中心的点即可：

if (Mathf.Abs(Input.GetAxisRaw("Horizontal")) == 1f)
{
    Vector3 targetPos = movePoint.position + new Vector3(Input.GetAxisRaw("Horizontal"), 0, 0);
    // 对齐到网格中心
    targetPos = new Vector3(Mathf.Round(targetPos.x), Mathf.Round(targetPos.y), targetPos.z);
    if (!Physics2D.OverlapPoint(targetPos, moveBlockers))
    {
        movePoint.position += new Vector3(Input.GetAxisRaw("Horizontal"), 0, 0);
    }
}

2. 检查Tilemap碰撞体设置

• 确保Tilemap添加了Tilemap Collider 2D，并勾选Used By Composite，再添加Composite Collider 2D（可选，用于合并相邻瓦片的碰撞体，避免缝隙问题）。
• 确认墙体瓦片的碰撞体类型是Solid，且Is Trigger未勾选（Overlap系列方法默认不检测触发碰撞体）。
• 检查moveBlockers图层是否正确包含了Tilemap的墙体图层。

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