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

此检查会报告使用未在项目 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日