Unity코드 아키텍처와 품질

프로젝트 구조 정리 기본

Unity 프로젝트를 오래 유지하기 쉽게 만드는 폴더 구조, 이름 규칙, 내부 자산 분리 원칙을 정리합니다.

마지막 수정 2026년 3월 19일

기본 패턴

text
Assets/
  ProjectName/
    Art/
    Audio/
    Materials/
    Prefabs/
    Scenes/
    Scripts/
    UI/
  ThirdParty/

설명

  • Unity 공식 가이드는 팀이 합의한 폴더 구조와 이름 규칙을 문서화하고 일관되게 유지하라고 권장합니다.
  • 내부 제작 자산과 서드파티 에셋을 분리하면 업데이트와 충돌 관리가 쉬워집니다.
  • 루트에 폴더를 무분별하게 늘리기보다 Assets 아래에서 명확한 기준으로 정리하는 편이 좋습니다.
  • 테스트용 샌드박스 씬과 실험 자산도 따로 분리해 두면 운영 자산과 섞이지 않습니다.

짧은 예제

text
Assets/
  MyGame/
    Scenes/
      MainMenu.unity
      Stage01.unity
    Scripts/
      Core/
      Gameplay/
      UI/
    Prefabs/
      Characters/
      Environment/
  ThirdParty/
    Cinemachine/
    DOTween/

빠른 정리

항목설명
내부 자산 분리우리 자산과 외부 패키지를 구분
이름 규칙 문서화팀 전체가 같은 기준 사용
테스트 영역 분리실험용 씬과 프로덕션 자산 혼선 감소
폴더 일관성새 프로젝트에서도 재사용 가능
루트 최소화탐색 비용과 충돌 가능성 감소

주의할 점

구조를 자주 바꾸면 참조보다도 협업 비용이 더 커질 수 있습니다. 완벽한 구조를 찾기보다 초기에 기준을 정하고 크게 흔들지 않는 편이 더 실용적입니다.

참고 링크

2 sources