Unity中如何检测碰撞对象是否属于指定Layer？

我在制作游戏梯子系统时，遇到了LayerMask检测碰撞对象所属层级无效的问题——保留LayerMask判断语句时，梯子的触发逻辑完全不生效，但移除判断语句后功能正常。

原问题代码如下：

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

public class Ladder : MonoBehaviour
{
    public Transform chController;
    public bool inside = false;
    public float speedUpDown = 3.2f;
    private ConciseMovement FPSInput;
    public LayerMask layerMask = 8;

    void Start()
    {
        FPSInput = GetComponent<ConciseMovement>();
        inside = false;
    }

    void OnTriggerEnter(Collider other)
    {
        if (other.gameObject.layer == layerMask)
        {
            inside = true;
        }
    }

    void OnTriggerExit(Collider other)
    {
        if (other.gameObject.layer == layerMask)
        {
            inside = false;
        }
    }

    void Update()
    {
        if (inside && Input.GetKey("w"))
        {
            chController.transform.position += Vector3.up / speedUpDown;
        }

        if (inside && Input.GetKey("s"))
        {
            chController.transform.position += Vector3.down / speedUpDown;
        }

        if (inside)
        {
            Debug.Log("is Ladder");
            GetComponent<ConciseMovement>().enabled = false;
        }
        else
        {
            Debug.Log("Not Ladder");
        }
    }
}

问题根源 #

原代码的核心错误在于对LayerMask的理解偏差：

• other.gameObject.layer返回的是层级索引值（范围0~31），比如"Ladder"层级如果是第8层，返回值就是8；
• 而LayerMask是位掩码整数，比如要表示第8层，正确的位掩码值是1 << 8（即256），直接赋值layerMask = 8对应的是第3层（因为2^3=8），且用==比较层级索引和位掩码的数值逻辑完全错误，导致判断永远不成立。

正确的LayerMask检测方式 #

可以用以下两种方法修正判断逻辑：

1. 通过层级名称判断（直观易懂）：

void OnTriggerEnter(Collider other)
{
    if (LayerMask.LayerToName(other.gameObject.layer) == "Ladder")
    {
        inside = true;
    }
}

void OnTriggerExit(Collider other)
{
    if (LayerMask.LayerToName(other.gameObject.layer) == "Ladder")
    {
        inside = false;
    }
}

2. 用位运算判断对象层级是否在LayerMask范围内（性能更优）：

void OnTriggerEnter(Collider other)
{
    if (((1 << other.gameObject.layer) & layerMask) != 0)
    {
        inside = true;
    }
}

void OnTriggerExit(Collider other)
{
    if (((1 << other.gameObject.layer) & layerMask) != 0)
    {
        inside = false;
    }
}

我的替代方案 #

我最终改用检测目标对象是否带有climbable脚本的方式实现了需求，现将原问题代码和分析保留，供遇到同类LayerMask使用问题的开发者参考。

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