Git은 소프트웨어 개발 과정에서 소스 코드의 변경 사항을 추적하기 위해 주로 사용되는 분산 버전 관리 시스템입니다. GitHub는 Git을 기반으로 한 온라인 버전 관리 호스팅 서비스로, 개발자들에게 필수적인 도구로 자리 잡았습니다. 그런데 최근 macOS 환경에서 터미널로 "git" 명령어를 실행할 때 "fatal: 'origin' does not appear to be a git repository" 오류가 발생한다는 사용자 보고가 잇따르고 있습니다.
이 글에서는 해당 오류가 발생하는 원인을 살펴보고, 문제를 해결할 수 있는 실질적인 방법들을 단계별로 안내해 드립니다. 오류 없이 원활하게 진행하려면 가이드를 순서대로 주의 깊게 따라 하시기 바랍니다.
"fatal: 'origin'이 Git 저장소로 인식되지 않습니다" 오류의 원인
다수의 사용자로부터 접수된 보고를 바탕으로 문제를 분석한 결과, 이 오류는 주로 다음과 같은 원인으로 발생하는 것으로 확인되었습니다.
- Origin 누락: 이 오류는 대부분 "Origin"이 설정되어 있지 않을 때 발생합니다. Origin은 GitHub 포크(fork) 저장소를 가리키는 참조 값으로, 이것이 없으면 일부 Git 명령어가 정상적으로 작동하지 않습니다.
- 잘못된 URL 설정: 경우에 따라 저장소에 설정된 원격(remote) URL이 잘못 지정되어 있어 수정이 필요할 수 있습니다. URL이 올바르지 않으면 관련 명령어들이 정상적으로 동작하지 않습니다.
문제의 원인을 파악했으니, 이제 각 상황에 맞는 해결 방법을 알아보겠습니다.
방법 1: Origin 직접 추가하기
Origin(포크 저장소 참조)이 누락되면 특정 명령어가 작동하지 않을 수 있습니다. 이 경우 Origin을 수동으로 추가하면 문제가 해결됩니다.
- Command + Space 키를 동시에 눌러 Spotlight 검색을 엽니다.
- "터미널(Terminal)"을 입력하고 Enter 키를 눌러 실행합니다.
- 아래 명령어를 입력하고 Enter 키를 누릅니다.
git remote -v
- 목록에 "Origin"이라는 이름의 원격 저장소가 등록되어 있는지 확인합니다.
- 목록에 없다면 현재 프로젝트에 "Origin"이 설정되지 않은 상태입니다.
- 아래 명령어를 입력해 Origin을 추가합니다. 저장소 URL 부분은 본인의 포크 저장소 주소로 변경하세요.
git remote add origin url/to/your/fork
- 오류가 여전히 발생하는지 확인합니다.
방법 2: 원격 저장소 URL 변경하기
원격 저장소 URL이 잘못 지정되어 있으면 Git의 일부 기능이 정상적으로 작동하지 않을 수 있습니다. 이 경우 URL을 올바른 주소로 변경해야 합니다.
- Command + Space 키를 동시에 눌러 Spotlight 검색을 엽니다.
- "터미널(Terminal)"을 입력하고 Enter 키를 눌러 실행합니다.
- 아래 명령어를 사용해 URL을 변경합니다. 사용자명과 저장소 이름은 본인의 계정 정보로 교체하세요.
git remote set-url origin ssh://git@github.com/username/newRepoName.git
- 변경 후 오류가 해결되었는지 확인합니다.
방법 3: Origin을 Master 브랜치로 변경하기
Master 브랜치에서 코드를 가져오려는 경우, 원격 저장소를 추가하거나 삭제하기 전에 먼저 origin을 master로 지정해야 할 수 있습니다. 이 경우 아래 방법을 따라 해 보세요.
- Command + Space 키를 동시에 눌러 Spotlight 검색을 엽니다.
- "터미널(Terminal)"을 입력하고 Enter 키를 눌러 실행합니다.
- 아래 명령어를 입력해 Origin을 master 브랜치로 변경합니다.
git pull origin master