---
title: C# 리플렉션 오버헤드 방지
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/analysis/performance-memory/managed-memory/gc-avoid-reflection
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/analysis/performance-memory/managed-memory/gc-avoid-reflection.md
last_updated: 2026-10-03
generated_at: 2026-11-19T18:12:15.649Z
locale: ko-kr
---

# C# 리플렉션 오버헤드 방지

> 런타임 시 C# 반사를 사용하지 않도록 가비지 컬렉터 오버헤드를 줄입니다.

[Mono](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/mono.md) 및 [IL2CPP](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp.md) 스크립팅 백엔드 모두 내부적으로 모든 C# [`System.Reflection`](https://learn.microsoft.com/en-us/dotnet/api/system.reflection?view=net-9.0) 오브젝트를 캐싱하고 Unity는 이를 가비지로 수집하지 않습니다. 즉, 가비지 컬렉터 애플리케이션의 수명 동안 캐시된 C# 반사 오브젝트를 지속적으로 스캔하여 불필요하고 잠재적으로 상당한 가비지 컬렉터 오버헤드를 일으킵니다.

가비지 컬렉터 오버헤드를 최소화하려면 런타임 시점에 많은 C# 반사 오브젝트를 생성하는 방법(예: [`Assembly.GetTypes`](https://docs.microsoft.com/en-us/dotnet/api/system.reflection.assembly.gettypes) 및 [`Type.GetMethods`](https://docs.microsoft.com/en-us/dotnet/api/system.type.getmethods))을 사용하지 마십시오. 대신 Unity 에디터 어셈블리를 스캔하여 필요한 데이터를 직렬화하거나 코드 생성을 사용하여 데이터를 런타임 시 사용할 수 있도록 합니다.

## 에디터에서 어셈블리 스캔##scan-assemblies-in-the-editor

다음 예시는 에디터에서 어셈블리를 스캔하고, 데이터를 직렬화하고, 이를 반사 없이 런타임에 사용하는 방법을 보여줍니다. `IMyFeature`라는 인터페이스를 구현하고 런타임 시 해당 정보를 사용하는 모든 타입을 찾고자 합니다. 다음과 같이 모든 타입을 스캔하여 `IMyFeature`를 구현하고 이름을 `ScriptableObject` 또는 JSON 파일에 저장하는 에디터 스크립트를 작성할 수 있습니다.

```lang-cs
using UnityEngine;
using UnityEditor;
using System;
using System.Linq;
using System.Reflection;
using System.Collections.Generic;

[CreateAssetMenu(menuName = "Feature/FeatureTypeList")]
public class FeatureTypeList : ScriptableObject
{
    public List<string> typeNames;
}

public static class FeatureTypeScanner
{
    [MenuItem("Tools/Scan IMyFeature Types")]
    public static void ScanTypes()
    {
        var featureType = typeof(IMyFeature);
        var types = AppDomain.CurrentDomain.GetAssemblies()
            .SelectMany(a => a.GetTypes())
            .Where(t => featureType.IsAssignableFrom(t) && !t.IsInterface && !t.IsAbstract)
            .Select(t => t.FullName)
            .ToList();

        // Create/overwrite the asset
        var asset = ScriptableObject.CreateInstance<FeatureTypeList>();
        asset.typeNames = types;
        AssetDatabase.CreateAsset(asset, "Assets/FeatureTypeList.asset");
        AssetDatabase.SaveAssets();

        Debug.Log($"IMyFeature를 구현하는 찾은 {types.Count} 타입입니다. FeatureTypeList.asset"에 저장됨);
    }
}
```

메뉴에서 **Tools > Scan IMyFeature Types**를 실행합니다. 그러면 유형 이름 목록이 포함된 `Assets/FeatureTypeList.asset`가 생성됩니다.

런타임 시 이 에셋을 로드하고 `Activator.CreateInstance`를 통해 인스턴스화하거나 표시를 위해 유형 이름을 사용할 수 있습니다. 다음과 같이 코드겐을 사용하는 경우에는 반사가 필요하지 않습니다.

```lang-cs
public class FeatureTypeLoader : MonoBehaviour
{
    public FeatureTypeList featureTypes;

    void Start()
    {
        var assemblyName = this.GetType().Assembly.FullName;
        Foreach(featureTypes.typeNames의 var typeName)
        {
            Debug.Log("Instantiating feature type: " + typeName);
            Activator.CreateInstance(assemblyName, typeName);
            // You can also use Type.GetType(typeName) (both of these still uses reflection but only on the pre-selected feature types instead of casting a wider net across all sort of types in the assembly.)
        }
    }
}
```

## 코드 생성 사용##use-code-generation

타입 이름을 저장하는 대신 타입 또는 델리게이트의 정적 배열을 포함하는 C# 파일을 에디터 시점에 생성하여 모든 런타임 반사를 제거할 수 있습니다. 다음 코드 예제는 반사 없이 런타임에 사용할 수 있는 검색된 타입의 정적 배열로 파일 `Assets/GeneratedFeatureTypes.cs`를 생성합니다.

```lang-cs
using UnityEditor;
using System;
using System.Linq;
using System.Text;
using System.IO;

public static class FeatureTypeCodeGen
{
    [MenuItem("툴/CodeGen IMyFeature 타입")]
    public static void CodeGenTypes()
    {
        var featureType = typeof(IMyFeature);
        var types = AppDomain.CurrentDomain.GetAssemblies()
            .SelectMany(a => a.GetTypes())
            .Where(t => featureType.IsAssignableFrom(t) && !t.IsInterface && !t.IsAbstract)
            .ToList();

        StringBuilder sb = new StringBuilder();
        sb.AppendLine("public static class GeneratedFeatureTypes {");
        sb.AppendLine("    public static readonly System.Type[] Types = new System.Type[] {");
        Foreach (var t in types)
        {
            sb.AppendLine($"        typeof({t.FullName}),");
        }
        sb.AppendLine("    };");
        sb.AppendLine("}");

        File.WriteAllText("Assets/GeneratedFeatureTypes.cs", sb.ToString());
        AssetDatabase.Refresh();
        Debug.Log("Generated FeatureTypes.cs with " + types.Count + " types.");
    }
}
```

## 추가 리소스##additional-resources

* [가비지 컬렉션 모드](/engine/6000.0/manual/analysis/performance-memory/managed-memory/incremental-garbage-collection.md)
* [가비지 컬렉션 설정](/engine/6000.0/manual/analysis/performance-memory/managed-memory/disabling-garbage-collection.md)
* [관리되는 메모리를 위한 코드 최적화](/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory.md)
