Unity中Physics.Raycast结合LayerMask无法忽略指定层求助

看起来你遇到的问题大概率是层名称转换环节出了问题，导致生成的LayerMask没有正确包含你要忽略的层。我来一步步帮你排查和解决：

问题根源分析 #

你当前的代码用了LayerMask.LayerToName(21)来获取层名称，再传给LayerMask.GetMask()生成掩码。但这里有个隐藏坑：如果层21没有被手动设置过名称，LayerToName(21)会返回空字符串，而GetMask()遇到空字符串时会直接忽略这个参数，相当于只尝试生成层0的掩码。最终你的layerMask实际上只忽略了层0，层21根本没被加入到忽略列表里，所以射线还是会命中层21的对象。

直接可靠的解决方案：跳过名称转换，用层索引计算掩码 #

最稳妥的方式是直接通过层索引的位运算来生成掩码，避免名称转换带来的意外问题：

// 先计算出要忽略的层对应的掩码：把层21和0的位设为1
int layersToIgnore = (1 << 21) | (1 << 0);
// 取反得到射线检测时要包含的层掩码（即忽略上述两层）
int layerMask = ~layersToIgnore;

// 建议加个日志验证一下掩码是否正确
Debug.Log($"要忽略的层掩码：{layersToIgnore}，最终检测掩码：{layerMask}");

if (Physics.Raycast(position, direction, out hit, maxDistance, layerMask)) {
    // 额外打印命中的层，确认是否符合预期
    Debug.Log($"命中对象的层：{hit.transform.gameObject.layer}");
    if (XLayers.shouldDoStuff(hit.transform.gameObject.layer)) {
        // 执行操作
    } else{
        // 其他操作
    }
} else {
    // 其他操作
}

额外排查步骤 #

如果上面的方法还没解决问题，可以再检查这几点：

• 确认对象的层确实是21：有时候可能误改了对象的层，或者父对象/子对象的层不一致，通过Debug.Log打印命中对象的层就能确认。
• 验证掩码的二进制值：用Convert.ToString(layerMask, 2)打印掩码的二进制字符串，看看第0位和第21位是否被置为0（因为取反后，原来要忽略的层对应的位会变成0，射线就不会检测这些层）。
• 检查Raycast重载参数：虽然你说用了正确的重载，但再确认一下参数顺序：Physics.Raycast(Vector3 origin, Vector3 direction, out RaycastHit hitInfo, float maxDistance, int layerMask)，确保maxDistance和layerMask没有搞混。

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