[GIT] Clone succeeded, but checkout failed. You can inspect what was checked out with 'git status' and retry with 'git restore --source=HEAD :/' 해결방법

문제발견

github의 repository를 clone해서 데스크톱으로 가져오려 하는데 다음과 같은 오류가 확인된다.

무슨 오류인지 내용으로봐선 자세히 알 수 없다.

You can inspect what was checked out with 'git status' and retry with 'git restore --source=HEAD :/'

 

위에 나온대로 git status를 clone시킬 경로에서 쳐봐도 뭔가 미적지근한 응답이 나온다.

원인분석

이렇게 에러가 뜨더라도 git 디렉토리는 생성이 되어있길래 로컬로 열어봤다.
그러니 repository를 clone 해오진 않은 상태로 나타났다.

연습삼아 Summary와 Descripttions을 입력 후 commit을 눌러보니 에러 원인을 찾을 수 있었다.

error: invalid path 'CI-CD/CD란 무엇인가?'
fatal: make_cache_entry failed for path 'CI-CD/CD란 무엇인가?'

즉 파일명에 문제가 있다는 이야기다.
찾아보니 git과 windows를 연동시키는데 파일명에 들어가면 안될 문자들이 존재했다.

대응방법 확인

git에 넣을 파일명에는 (?, *, \ 등이 포함된) 파일을 pull하거나 할 때 오류가 나므로
해당하는 파일의 파일명을 변경 해줘야 할 것으로 보인다.

해당 리포지토리의 모든 파일을 점검하여 파일명 변경이 필요한 부분은 변경했다.

문제 해결

오류나던게 없어지고 정상적으로 clone이 잘 되었다.