[git] checkout 및 pull 에러 (The following untracked working tree files would be overwritten by checkout)

갑자기 잘되던 checkout과 pull이 안되어 오전부터 당황 😅 다시 헤매지 않기 위해 해결방법을 작성해두려 한다.

에러 메시지는 다음과 같았다.

error: The following untracked working tree files would be overwritten by checkout (혹은 by merge):
.../.../UserNAuthVO.java
Please move or remove them before you merge.
Aborting

언급된 UserNAuthVO는 팀원이 작업하고 있는 파일이었고, 나는 건드릴 일이 없는 파일이었는데 갑자기 충돌이 발생한 상황이었다. 🤔 그렇기에 나와 같은 case에서는 git stash 해결법도 먹히지 않아 눈앞이 캄캄했다.

몇 시간 고민 끝에 파일명에 문제가 있음을 느꼈다. (카멜케이스가 복잡하게 사용될 것 같은 파일명이어서 추측이 가능했다.)

UserNAuthVO 파일명의 대소문자만 변경된 후 main에 올려졌을 때, main pull 시 git은 나의 로컬에서 파일을 수정한 것으로 여겨 충돌이 난 것이었다.

해결방법: 파일명 대소문자 구분 여부 설정

git config --global core.ignorecase true // true: 대소문자 구분 무시, false: 대소문자 구분

위 명령어로 대소문자 구분을 무시하도록 하여 git은 로컬에서 수정사항이 없는 것으로 인식해 정상적으로 pull과 checkout이 가능해졌다!! ✨