代码检查：构建设置中没有同名场景

当场景在项目中存在但未包含在 Unity 构建设置中时，此检查会报告传递给 SceneManager.LoadScene(...) 及相关 API 的场景名称。

这与完全缺失场景文件不同。当字符串指向一个真实的场景资源，但该场景未包含在 EditorBuildSettings 中时，检查会发出警告，因此无法在运行时通过名称加载该场景。

示例

在此示例中， "Gameplay" 场景被加载，但未添加到构建设置中。快速修复会将该场景添加到构建设置中。

                using UnityEngine.SceneManagement;

                public class Example
                {
                    public void Load()
                    {
                        // Reported: scene 'Gameplay' is not in build settings
                        SceneManager.LoadScene("Gameplay");
                    }
                }
            
   

                using UnityEngine.SceneManagement;

                public class Example
                {
                    public void Load()
                    {
                        // Scene 'Gameplay' is added to build settings
                        SceneManager.LoadScene("Scenes/Gameplay");
                    }
                }
            
   

快速修复

快速修复可将匹配的场景添加到 Unity 构建设置中。如果多个场景共享相同的短名称，还可以将实参替换为准确的场景路径表示。

对于包含多个匹配场景的项目，请选择目标场景条目，这样调用也可以更新为正确的基于路径的名称。

2026年 5月 8日