Compare

헷갈리는 어트리뷰트 조합

Unity 어트리뷰트는 이름만 보면 비슷해 보이지만, 실제로는 붙이는 위치와 해결하는 문제가 다른 경우가 많습니다.

[SerializeField] vs public

public int hp;

• Inspector에 보입니다.
• 다른 클래스에서 접근할 수 있습니다.
• 값 보호가 약해집니다.

[SerializeField]
private int hp;

• Inspector에 보입니다.
• 다른 클래스에서 마음대로 바꾸기 어렵습니다.
• Unity 프로젝트에서 더 자주 권장되는 형태입니다.

정리: Inspector에 보이게 하려는 목적이라면 public보다 [SerializeField] private을 먼저 생각합니다.

[System.Serializable] vs [SerializeField]

[System.Serializable]
public class ItemData
{
    public string itemName;
    public int count;
}

[System.Serializable]은 타입 자체를 Unity가 직렬화 가능한 데이터 구조로 볼 수 있게 합니다.

[SerializeField]
private ItemData item;

[SerializeField]는 특정 필드를 Unity 직렬화 대상으로 만듭니다.

정리: 커스텀 class를 private 필드로 Inspector에 보이게 하려면 보통 둘 다 필요합니다.

[SerializeReference] vs ScriptableObject

정리: 여러 곳에서 공유할 데이터라면 ScriptableObject, 특정 오브젝트 내부의 다형성 데이터라면 [SerializeReference]를 고려합니다.

[ContextMenu] vs [MenuItem]

public class EnemySpawner : MonoBehaviour
{
    [ContextMenu("Spawn Test Enemy")]
    private void SpawnTestEnemy()
    {
    }
}

using UnityEditor;

public static class CombatMenu
{
    [MenuItem("Combat/Setup Animated Agent Prefabs")]
    private static void Setup()
    {
    }
}

정리: 특정 컴포넌트의 작은 기능이면 [ContextMenu], 에디터 메뉴에 등록할 도구면 [MenuItem]입니다.

[ExecuteAlways] vs [ExecuteInEditMode]

[ExecuteAlways]
public class AutoAligner : MonoBehaviour
{
    private void Update()
    {
        if (Application.isPlaying)
        {
            return;
        }

        // Edit Mode 전용 미리보기 코드
    }
}

정리: 새로 작성한다면 대체로 [ExecuteAlways]를 먼저 보고, Play Mode와 Edit Mode를 반드시 구분합니다.

[Range] vs [Min]

[Range(0, 100)]
public int hp;

• Inspector에서 슬라이더로 표시됩니다.
• 최소값과 최대값이 모두 있을 때 적합합니다.

[Min(0)]
public int gold;

• 최소값만 제한합니다.
• 최대값이 없는 값에 적합합니다.

정리: 범위가 명확하면 [Range], 음수만 막고 싶으면 [Min]입니다.

[CustomEditor] vs [CustomPropertyDrawer]

정리: Inspector 전체를 바꾸려면 [CustomEditor], 필드 하나의 표현을 바꾸려면 [CustomPropertyDrawer]입니다.

[InitializeOnLoad] vs [RuntimeInitializeOnLoadMethod]

정리: 에디터 도구 초기화는 [InitializeOnLoad], 게임 실행 초기화는 [RuntimeInitializeOnLoadMethod]입니다.