상담 신청
홈 › 작업 노트 › 개발 › 깃으로 게임 프로젝트를 관리할 때 무시할 파일

개발 · 도구 다루기

깃으로 게임 프로젝트를 관리할 때 무시할 파일

Unity 프로젝트를 처음 깃에 올리려는데 파일이 수만 개라며 한참을 멈춰 있습니다. 겨우 올리고 나면 팀원이 받을 때마다 충돌이 나고, 저장소 용량은 금세 몇 기가바이트가 됩니다. 원인 대부분은 올리지 않아도 되는 파일을 함께 올린 데 있습니다. 무엇을 빼야 하는지는 그 파일을 누가 다시 만들 수 있는지로 정하면 쉽습니다.

작업 노트 408 · 읽는 시간 약 5분 · 2026.11.17 정리

무시 목록의 기준: 다시 만들 수 있는 파일인가

깃은 사람이 직접 만든 원본을 기록하는 도구입니다. 코드, 씬, 프리팹, 설정 파일처럼 사람이 만들고 고친 파일은 올려야 합니다. 반대로 엔진이나 컴파일러가 원본을 바탕으로 자동으로 만드는 파일은 올릴 필요가 없습니다. 원본만 있으면 언제든 다시 만들 수 있고, 오히려 올리면 컴퓨터마다 내용이 달라 쓸데없는 변경과 충돌만 생깁니다.

두 번째 기준은 그 파일이 나에게만 해당하는가입니다. 에디터 창 배치, 최근 연 파일 목록, 개인 계정 정보 같은 것은 팀원마다 달라야 정상입니다. 이런 파일을 올리면 팀원이 받을 때마다 내 화면 배치로 바뀌거나, 서로의 설정을 계속 덮어쓰게 됩니다. 개인 설정은 각자 컴퓨터에만 두는 것이 원칙입니다.

무시할 파일 목록은 프로젝트 맨 위 폴더의 .gitignore라는 파일에 한 줄씩 적습니다. 폴더 이름이나 파일 패턴을 적어 두면 깃이 그 파일을 변경 목록에 보여 주지 않습니다. 프로젝트를 시작하자마자, 첫 커밋 전에 만들어 두는 것이 가장 중요합니다. 이미 올라간 파일은 이 목록에 적어도 계속 추적되기 때문입니다.

Unity 프로젝트에서 올릴 폴더와 뺄 폴더

구분폴더이유
올린다Assets, Packages, ProjectSettings직접 만든 리소스와 코드, 사용하는 패키지 목록, 프로젝트 설정이 들어 있음
뺀다Library가져온 리소스를 엔진이 변환해 둔 캐시라 다시 만들 수 있고 용량이 큼
뺀다UserSettings에디터 화면 배치 같은 개인 설정
뺀다Temp, Obj, Logs, 빌드 결과 폴더실행 중 임시 파일, 컴파일 중간 결과, 기록, 내보낸 실행 파일

Unity 공식 매뉴얼은 Assets, Packages, ProjectSettings 폴더를 버전 관리에 넣고, Library와 UserSettings 폴더는 완전히 무시하라고 안내합니다. Library를 빼도 괜찮은 이유는 팀원이 프로젝트를 열면 Unity가 Assets 안의 원본을 다시 읽어 이 폴더를 새로 만들기 때문입니다. 처음 열 때 시간이 조금 걸리는 대신 저장소가 훨씬 가벼워집니다.

가장 자주 하는 실수는 반대 방향입니다. Assets 폴더 안의 .meta 파일까지 무시 목록에 넣는 경우입니다. 공식 매뉴얼은 새 에셋을 추가할 때 에셋 파일과 함께 그에 딸린 .meta 파일도 버전 관리에 넣으라고 안내합니다. .meta 파일에는 그 에셋을 다른 곳에서 찾아 연결하는 데 필요한 정보가 들어 있어서, 빠지면 팀원 컴퓨터에서 연결이 끊어져 프리팹의 참조가 사라지는 일이 생깁니다.

게임프로그래밍 수업에서 다루는 작업 예시
게임프로그래밍 수업에서 다루는 작업 예시

엔진 밖에서 생기는 파일도 챙기기

코드 편집기도 자기만의 파일을 만듭니다. 비주얼 스튜디오는 프로젝트 폴더 안에 개인 작업 상태를 담은 숨김 폴더와 사용자별 설정 파일을 만들고, 다른 편집기도 비슷한 설정 폴더를 둡니다. Unity 프로젝트에서는 편집기가 쓰는 프로젝트 파일과 솔루션 파일을 엔진이 자동으로 다시 만드는 경우가 많아, 이것도 무시 목록에 넣는 경우가 흔합니다.

운영체제가 만드는 파일도 있습니다. 폴더를 열 때 생기는 썸네일 캐시나 폴더 표시 설정 파일이 대표적입니다. 내용은 아무 의미가 없는데 팀원마다 생겼다 지워졌다 하며 변경 목록을 어지럽힙니다. 운영체제별로 생기는 이런 파일 이름을 미리 적어 두면 커밋할 때마다 하나씩 빼는 수고가 사라집니다.

처음부터 목록을 직접 다 쓸 필요는 없습니다. 깃허브에서 저장소를 만들 때 엔진별 무시 목록 양식을 고를 수 있고, 널리 쓰이는 양식 모음도 공개되어 있습니다. 다만 양식을 그대로 쓰기 전에 한 줄씩 읽어 보고, 우리 프로젝트에 해당하지 않거나 오히려 올려야 할 파일이 빠지지 않았는지 확인합니다. 이유를 모르고 쓴 목록은 문제가 생겼을 때 고치기 어렵습니다.

큰 리소스 파일과 비밀 정보는 따로 다루기

게임 프로젝트에는 텍스처, 사운드, 3D 모델처럼 덩치 큰 원본 파일이 많습니다. 이것들은 사람이 만든 원본이라 올려야 하지만, 깃은 파일이 바뀔 때마다 전체를 새로 저장하기 때문에 수정이 잦으면 저장소가 빠르게 불어납니다. 그래서 큰 파일은 별도 저장소에 두고 깃에는 연결 정보만 남기는 확장 기능을 쓰는 경우가 많습니다. 팀 프로젝트를 시작할 때 미리 정해 두는 편이 좋습니다.

포토샵 원본이나 3D 툴 작업 파일처럼 엔진에 들어가기 전 단계의 파일은 팀마다 관리 방식이 다릅니다. 같은 저장소에 두는 팀도 있고, 아트용 저장소를 따로 두는 팀도 있습니다. 어느 쪽이든 정해 두지 않으면 누군가는 올리고 누군가는 빼서 파일이 어디 있는지 헷갈립니다. 첫 회의 때 한 줄로 정해 두면 됩니다.

가장 조심할 것은 비밀 정보입니다. 서버 접속 주소와 비밀번호, 외부 서비스 키 같은 값이 들어간 설정 파일을 올리면 공개 저장소에서는 누구나 볼 수 있습니다. 이런 값은 별도 파일로 빼서 무시 목록에 넣고, 대신 값이 비어 있는 예시 파일만 올려 팀원이 복사해 쓰게 합니다. 한 번 올라간 비밀 정보는 기록에 남으므로 키를 새로 발급받아야 합니다.

게임프로그래밍 과정에서 만드는 결과물 예시
게임프로그래밍 과정에서 만드는 결과물 예시

이미 올라간 파일을 정리하는 순서

  1. 무시 목록 파일을 먼저 만들거나 고쳐서 빼야 할 폴더를 적는다.
  2. 깃의 추적 목록에서만 해당 파일을 지우는 명령으로 추적을 끊는다. 내 컴퓨터의 실제 파일은 남겨 둔다.
  3. 정리 내용을 한 번의 커밋으로 남기고, 메시지에 무엇을 왜 뺐는지 적는다.
  4. 팀원에게 알리고, 각자 받은 뒤 엔진을 열어 캐시가 다시 만들어지는지 확인한다.

두 번째 단계에서 추적만 끊는 명령은 git rm에 --cached 옵션을 붙여 씁니다. 옵션을 빼먹으면 내 컴퓨터의 파일까지 지워지니 꼭 확인합니다. 이 정리를 하고 나면 이후의 변경 목록에는 사람이 고친 파일만 남아 커밋 기록이 깔끔해집니다. 포트폴리오로 저장소를 보여 줄 때도 이런 정리 상태가 프로젝트 관리 습관을 그대로 드러냅니다.

팀 프로젝트를 시작하며 저장소 구성부터 막힌다면, SBS아카데미게임학원 게임프로그래밍 과정 무료 상담에서 지금 저장소 상태를 보여 주고 프로젝트 관리 습관을 함께 점검해 보세요.

자주 묻는 질문

혼자 하는 프로젝트도 무시 목록이 필요한가요?

필요합니다. 컴퓨터를 바꾸거나 다시 받을 때 같은 문제가 생기고, 포트폴리오로 공개할 때 정리되지 않은 저장소는 첫인상이 좋지 않습니다.

Unreal 프로젝트도 같은 원리인가요?

원리는 같습니다. 엔진과 컴파일러가 다시 만드는 중간 결과, 캐시, 개인 저장 폴더를 빼고 원본 콘텐츠와 설정, 소스를 올립니다. 폴더 이름은 엔진 버전에 맞는 공식 안내를 확인하세요.

확인한 자료

외부 기관의 기준과 안내는 바뀔 수 있으니 최신 내용은 해당 기관에서 확인해 주세요.

게임프로그래밍 수업 예시
이 글과 이어지는 과정게임프로그래밍 과정 안내

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

과정 보기 →

함께 읽으면 좋은 노트

무료 상담 신청

읽은 글과 관련해 궁금한 점이나 지금 상황을 남기면 담당자가 연락드립니다.

상담·컨설팅 무료 · 전화 상담 010-2135-9730

전화상담 신청