개발 · 점검 노트
프로젝트 폴더 구조를 정리했는지 확인하기
프로젝트를 시작한 지 한 달쯤 지나면 Assets 폴더에 New Material, Cube 1, test2 같은 이름이 쌓이고, 원하는 스크립트를 찾는 데 몇 분씩 걸리기 시작합니다. 혼자 작업할 때는 불편한 정도지만, 팀 작업이나 포트폴리오 제출 때는 큰 문제가 됩니다. 유니티 프로젝트 폴더가 잘 정리되어 있는지 확인할 항목과, 문제가 보일 때 고치는 방법을 점검 순서대로 정리했습니다.
작업 노트 480 · 읽는 시간 약 5분 · 2026.11.17 정리
점검 1: Assets 바로 아래가 역할별 폴더로 나뉘어 있는가
가장 먼저 Assets 폴더를 열어 바로 아래에 무엇이 있는지 봅니다. 파일이 폴더 없이 흩어져 있다면 정리가 필요한 상태입니다. 흔히 쓰는 방식은 Scenes, Scripts, Prefabs, Materials, Textures, Audio, Animations처럼 파일 종류별로 최상위 폴더를 나누는 것입니다.
이 항목을 보는 이유는 찾는 시간 때문입니다. 프로젝트 창의 검색 기능이 있긴 하지만, 이름을 정확히 모를 때는 폴더를 따라 들어가는 수밖에 없습니다. 또 팀원이 새 파일을 만들 때 어디에 둘지 고민하지 않게 해 주는 것도 폴더 구조의 역할입니다. 규칙이 없으면 사람마다 다른 곳에 파일을 두어 금세 엉킵니다.
문제를 발견했다면 유니티 편집기의 프로젝트 창 안에서 폴더를 만들고 파일을 끌어 옮깁니다. 운영체제의 파일 탐색기에서 직접 옮기면 유니티가 각 파일에 붙여 관리하는 메타 파일이 따라가지 않아 연결이 끊어질 수 있습니다. 편집기 안에서 옮기면 다른 오브젝트와의 참조가 유지됩니다. 큰 정리를 하기 전에는 반드시 백업이나 커밋을 먼저 해 둡니다.
점검 2: 외부 에셋과 내 작업물이 분리되어 있는가
에셋 스토어나 다른 곳에서 가져온 에셋은 대부분 자기 이름의 폴더를 Assets 바로 아래에 만듭니다. 여러 개를 가져오다 보면 내 작업 폴더와 외부 에셋 폴더가 뒤섞여, 어떤 것이 직접 만든 것인지 구분하기 어려워집니다. 외부 에셋은 별도의 상위 폴더 하나에 모아 두는 방식을 많이 씁니다.
이 항목이 중요한 이유는 포트폴리오와 이용 조건 때문입니다. 포트폴리오를 설명할 때 직접 만든 부분과 빌려 쓴 부분을 정확히 밝혀야 하고, 외부 에셋의 이용 조건을 다시 확인할 일도 생깁니다. 폴더가 분리되어 있으면 이 두 가지가 훨씬 쉬워집니다. 반대로 내 스크립트가 외부 에셋 폴더 안에 섞여 있으면 에셋을 업데이트하거나 지울 때 함께 사라질 위험이 있습니다.
외부 에셋 폴더를 옮길 때는 주의할 점이 있습니다. 일부 에셋은 특정 경로를 기준으로 동작하도록 만들어져 있어 옮긴 뒤 오류가 날 수 있습니다. 옮긴 다음에는 에셋의 예제 씬이나 내가 쓰는 부분을 열어 정상적으로 보이는지, 콘솔에 오류가 없는지 확인합니다. 문제가 있으면 원래 위치로 되돌리고 그대로 둡니다.

점검 3: 파일 이름만 보고 무엇인지 알 수 있는가
프로젝트 창을 훑어보며 기본 이름 그대로인 파일을 찾습니다. New Material, GameObject, Cube 1, NewBehaviourScript처럼 유니티가 자동으로 붙인 이름이 남아 있다면 바꿔야 할 대상입니다. 'Mat_Ground_Grass', 'Player_Move'처럼 종류, 대상, 역할이 드러나는 이름으로 바꾸면 폴더를 열지 않고 검색만으로도 원하는 파일을 찾을 수 있습니다.
이름 규칙은 팀이 하나로 정해 문서에 남깁니다. 단어를 밑줄로 이을지, 단어 첫 글자를 대문자로 쓸지, 접두어를 붙일지 같은 사소한 것까지 정해 두면 이름이 들쭉날쭉해지지 않습니다. 파일 이름에는 공백과 특수문자를 피하는 편이 안전하며, 팀원 간 운영체제가 다르다면 대소문자 차이로 문제가 생기지 않도록 일관되게 씁니다.
스크립트 이름을 바꿀 때는 특히 조심합니다. C# 스크립트는 파일 이름과 안의 클래스 이름이 맞아야 컴포넌트로 제대로 붙습니다. 파일 이름만 바꾸고 클래스 이름을 그대로 두면 오브젝트에 붙어 있던 스크립트가 연결을 잃을 수 있습니다. 이름을 바꾼 뒤에는 그 스크립트를 쓰는 오브젝트를 열어 컴포넌트가 정상인지 확인합니다.
점검 4: 쓰지 않는 파일과 시험용 씬이 정리되어 있는가
개발하다 보면 시험용 씬, 버린 스크립트, 쓰지 않는 이미지가 쌓입니다. test, temp, backup 같은 이름이 붙은 파일을 찾아 목록으로 적고, 하나씩 실제로 쓰이는지 확인합니다. 쓰지 않는 파일이 많으면 프로젝트를 여는 시간이 길어지고, 다른 사람이 프로젝트를 볼 때 무엇이 진짜 작업물인지 헷갈리게 됩니다.
바로 지우기 어렵다면 임시 보관 폴더를 하나 만들어 그곳으로 옮겨 둡니다. 일정 기간 동안 아무 문제가 없으면 그때 지웁니다. 지우기 전에는 반드시 백업이나 커밋을 해 두어, 나중에 필요해졌을 때 되찾을 수 있게 합니다. 파일을 지운 뒤에는 모든 씬을 한 번씩 열어 빠진 참조로 생긴 오류가 없는지 콘솔을 확인합니다.
버전 관리 도구를 쓴다면 저장소에 올리지 않아도 되는 폴더도 점검합니다. 유니티가 자동으로 다시 만들어 내는 캐시 폴더나 임시 폴더까지 올리면 저장소 용량이 불필요하게 커집니다. 유니티 프로젝트용으로 널리 쓰이는 제외 목록을 참고해 설정해 두면, 팀원 사이에 불필요한 충돌도 줄어듭니다.

점검 5: 처음 보는 사람이 프로젝트를 열고 바로 실행할 수 있는가
마지막 점검은 다른 사람의 눈으로 프로젝트를 여는 것입니다. 팀원이나 친구에게 프로젝트를 받아 열어 보게 하고, 어떤 씬을 열어야 게임이 시작되는지 바로 찾을 수 있는지 봅니다. 시작 씬의 이름을 분명히 하고, 프로젝트 최상위에 간단한 안내 문서를 두어 사용한 유니티 버전과 시작 씬, 조작법을 적어 두면 처음 보는 사람도 헤매지 않습니다.
이 점검은 포트폴리오에서 특히 중요합니다. 코드를 보고 싶어 하는 사람이 프로젝트를 열었을 때 폴더 구조가 정돈되어 있으면, 그것만으로도 작업 습관이 좋다는 인상을 줍니다. 정리 작업은 프로젝트 마지막에 몰아서 하기보다, 매주 한 번 짧게 점검하는 습관을 들이는 편이 훨씬 덜 힘듭니다. 창 이름과 메뉴 구성은 유니티 버전에 따라 조금 다를 수 있습니다.
SBS아카데미게임학원 유니티 과정은 게임 오브젝트 구성과 씬 관리, 에셋 활용법을 익힌 뒤 개인·팀 프로젝트로 포트폴리오를 완성하며, 강사진이 구성력까지 1:1로 점검합니다. 내 프로젝트 구조가 포트폴리오로 내보일 만한지 확인받고 싶다면 무료 상담에 프로젝트를 가져와 함께 살펴보세요.
자주 묻는 질문
폴더 구조에 정답이 있나요?
하나의 정답은 없습니다. 파일 종류별로 나누는 방식과 기능별로 나누는 방식이 모두 쓰입니다. 팀이 하나를 정해 일관되게 지키는 것이 가장 중요합니다.
프로젝트 중간에 구조를 바꿔도 되나요?
바꿔도 됩니다. 다만 백업이나 커밋을 먼저 하고, 편집기 안에서 옮긴 뒤 모든 씬이 정상인지 확인합니다. 팀 작업이라면 다른 팀원이 작업하지 않는 시간에 진행합니다.

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.
과정 보기 →