Git 유니티 파일충돌

문제점

Git에서 파일 충돌이 발생해서 병합이 실패했다. 주로 .idea파일이나, xml파일이 충돌이되었다.

로컬 develop 브랜치에 다른 브랜치들을 병합한후 origin에 올리려고 했으나, 원격 변경 내용을 병합해야 합니다 라는 메시지가 나오며 충돌이 떴다. 이유는 경로 이동에 따른 .meta 파일을 포함한 일괄 리네임충돌이 발생했다.

따라서 유니티파일에 대한 충돌처리를 해줘야했다.

시도해본것

 

• git checkout --ours / --theirs 명령어 사용.
• git pull --rebase, git merge, git stash 사용
• .idea 폴더를 .gitignore에 추가해 병합 대상에서 제외 시도.

 

해결한 방안

 

• 충돌이 난 파일은 git restore --source=origin/develop <> 으로 되돌리고 병합 해결.
• .idea/는 .gitignore에 명시하고 캐시에서 제거 (git rm -r --cached .idea).
• 리네임 충돌은 git mv로 명시적 이동 후 커밋 처리.
• 원격 브랜치 병합 문제는 git pull --rebase로 정리 후 push 성공.

 

알게 된 것

 

• Unity 프로젝트에서는 .meta 파일이 리네임되면 동일하게 변경되지 않으면 오류가 발생.
• Git 충돌 해결 시 .idea 같은 환경 관련 파일은 반드시 무시 설정 필요.
• 유니티의 애니메이션 관련 리네임은 .anim, .controller, .meta를 함께 관리해야 함.
• 또한, JetBrain사의 Rider사용시 다른 프로그램언어들은 대부분 에디터에서 요소가 생성되어 자동으로 버전관리에 들어가게 할 수 있지만, UnityHub를 주로 사용하게되면, 버전관리되지않은 파일들이 생성될 수도 있으니, 버전관리되지않은파일이 있다면 확인하는 습관이 필요함