UE5 협업을 위한 Git 사용법 학습

1. 필수 명령어

• git pull: 원격 저장소의 변경 사항을 로컬로 가져오기 (작업 시작 전 필수).
• git add <파일명>: 수정된 파일을 스테이징 영역에 추가.
• git commit -m "메시지": 변경 사항 기록.
• git push: 로컬 기록을 원격 저장소에 업로드.
• git status: 현재 수정된 파일 및 상태 확인.

2. 언리얼 엔진 필수 설정 (.gitignore)

프로젝트 루트 폴더에 아래 항목을 제외하는 설정 파일을 생성하여 바이너리/임시 파일 업로드 방지:

• Binaries/
• Intermediate/
• Saved/
• DerivedDataCache/
• .vs/
• *.sln (C++ 프로젝트인 경우 필요에 따라 제외)

3. 대용량 파일 관리 (Git LFS)

.uasset, .umap, 대용량 텍스처, FBX 등 바이너리 파일은 Git LFS를 통해 추적해야 저장소 용량 폭발 및 속도 저하를 방지할 수 있음.

• git lfs install: LFS 초기화.
• git lfs track "*.uasset": 특정 확장자 추적 설정.

4. 충돌(Conflict) 해결 프로세스

1. 발생 원인: 두 명 이상이 동일한 파일(특히 블루프린트)을 동시에 수정하고 Push 할 때 발생.
2. 해결:
   • 코드(.cpp, .h): 텍스트 기반 비교 후 수동 병합.
   • 에셋(.uasset): 언리얼 내장 'Merge Tool' 사용 혹은 한 명의 버전을 선택하여 덮어쓰기.