유니티 프로젝트의 .gitignore 설정, 작동이 안 될 때 대처법
".gitignore에 분명 추가했는데 왜 자꾸 커밋될까요?" 유니티 프로젝트에서 자주 겪는 .gitignore 문제, 직접 해결해봤습니다.
안녕하세요, 개발자 여러분! 최근에 유니티 프로젝트를 Git으로 관리하면서 아주 당황스러운 경험을 했어요. 분명히 .gitignore 파일을 제대로 설정했다고 생각했는데, 어느 날 보니 빌드 파일이 Git에 올라가 있는 거예요. 🤯 "이건 왜 이러지?" 하고 며칠을 헤매다가 결국 해결했는데, 같은 문제로 고민하는 분들이 많을 것 같아 이 글을 준비했습니다. 오늘은 .gitignore 설정 팁부터 작동하지 않을 때의 해결 방법까지, 제가 직접 겪은 시행착오를 바탕으로 꼼꼼히 정리해드릴게요.
.gitignore의 역할과 유니티에서 중요한 이유
.gitignore는 Git이 특정 파일이나 폴더를 추적하지 않도록 설정하는 파일이에요. 유니티 프로젝트에서는 특히 라이브러리 파일, 빌드 결과물, 임시 파일처럼 불필요하거나 공유해서는 안 되는 파일이 많기 때문에, .gitignore 설정이 매우 중요하죠. 잘못하면 팀원들에게 수백 메가짜리 라이브러리 폴더를 강제로 푸시할 수도 있어요. 😵💫
유니티 권장 .gitignore 기본 설정
| 제외 대상 | 설명 |
|---|---|
| /Library/ | 플랫폼/기기별 종속성이 있는 캐시 데이터 |
| /Temp/ | 빌드 중 생성되는 임시 파일 |
| /Build/ | 완성된 빌드 결과물 폴더 |
| *.csproj, *.sln | IDE에서 자동 생성되는 프로젝트 파일 |
Unity 프로젝트에서 꼭 무시해야 할 폴더/파일 예시
- /Library/
- /Temp/
- /Obj/
- /Build/
- /Builds/
- /Logs/
- *.csproj, *.sln, *.user
- *.pidb, *.suo, *.userprefs
- .vs/
- *.apk, *.aab, *.unitypackage
.gitignore가 제대로 작동하지 않는 주요 원인과 해결법
".gitignore에 추가했는데도 왜 자꾸 올라갈까?" 이런 상황이 발생했다면 아래 리스트를 꼭 확인해 보세요. 저도 이거 하나씩 점검하면서 문제를 해결했답니다.
기존 .gitignore의 경로 앞에 **/를 붙여 하위 폴더까지 적용되도록 수정합니다
오늘은 유니티 프로젝트에서 .gitignore 설정이 왜 제대로 작동하지 않을 때가 있는지, 그 원인과 해결법을 낱낱이 파헤쳐봤어요. 저도 처음엔 왜 커밋에 자꾸 이상한 파일이 딸려오는지 몰라 진짜 스트레스였거든요. 😤 하지만 하나하나 원인을 분석해보니 생각보다 단순한 문제들이더라고요. 여러분도 혹시 비슷한 문제로 고생하고 계시다면, 오늘 소개한 팁들을 꼭 적용해보세요! 혹시 다른 궁금한 점 있으시면 댓글로 남겨주세요. 함께 해결해봐요. 😉
'게임 콘텐츠 개발 > Git' 카테고리의 다른 글
| Git의 핵심 명령어 (0) | 2025.05.10 |
|---|---|
| Git과 GitHub의 개념 완벽 이해 (1) | 2025.05.10 |