代码检查：图层未在 'Tags & Layers' 中定义

此检查会报告在项目标签 & 层设置中未定义图层名称的与图层相关的 API 调用。

这适用于 LayerMask.NameToLayer 和 LayerMask.GetMask 等 API。如果图层名称不存在，调用很可能在运行时失败或返回意外结果。

示例

在本例中，使用了图层名称 "Enemies" ，但项目设置中只存在 "Enemy"。

                using UnityEngine;

                public class Example : MonoBehaviour
                {
                    void Start()
                    {
                        // Reported: "Enemies" does not exist in project settings
                        var enemyLayer = LayerMask.NameToLayer("Enemies");
                    }
                }
            
   

                using UnityEngine;

                public class Example : MonoBehaviour
                {
                    void Start()
                    {
                        // "Enemy" is a defined layer in the project
                        var enemyLayer = LayerMask.NameToLayer("Enemy");
                    }
                }
            
   

快速修复

此检查不提供专用快速修复。请手动修正图层名称，或在 Unity 项目设置中添加缺失的图层。

2026年 5月 8日