Git 기초 : Git 첫 커밋에서 Author identity unknown 뜰 때 해결 방법 (Windows Git Bash)

 

 

만약에 처음으로 특정 Repository에 연결하려고 한다면 

Git 첫 커밋에서 Author identity unknown 뜰 때

Git 첫 커밋에서 Author identity unknown 뜰 때 해결 방법 (Windows Git Bash)

처음으로 Git을 사용해 커밋을 하려는데 아래처럼 에러가 뜨는 경우가 있다.

 

Author identity unknown *** Please tell me who you are. fatal: unable to auto-detect email address (got 'hylee@yeona_lee.(none)')

이 글은 Windows + Git Bash 환경에서 이 문제를 해결하고, main 브랜치로 정상 push까지 하는 과정을 정리한 글이다.

---

1) 에러 원인: Git이 커밋 작성자 정보를 모르기 때문

Git은 커밋을 만들 때 작성자 이름(name) 과 이메일(email) 을 커밋 메타데이터로 함께 저장한다.
그런데 처음 세팅한 PC라면 이 정보가 없어서 Author identity unknown 에러가 발생한다.

---

2) 해결: user.name, user.email 설정하기 (Global 추천)

아래 명령으로 내 컴퓨터 전체(모든 repo)에 기본 작성자 정보를 설정할 수 있다.

 

git config --global user.name "yeona-lee-researcher"

git config --global user.email "yeona-lee-researcher@users.noreply.github.com"

• --global : 이 PC에서 만드는 모든 Git 저장소에 적용
• 이메일을 공개하고 싶지 않다면 @users.noreply.github.com 형태를 쓰는 게 안전하다.

설정이 잘 되었는지 확인:

 

git config --global --list

출력 예시는 이런 형태다.

 

user.name=yeona-lee-researcher

user.email=yeona-lee-researcher@users.noreply.github.com

 

3) 브랜치 이름을 main으로 맞추기

예전 Git 기본 브랜치는 master였고, 요즘은 대부분 main을 사용한다.
프로젝트에서 main으로 통일하려면 아래처럼 바꾼다.

 

git branch -M main

현재 브랜치 확인:

 

git branch

---

4) 커밋 다시 시도 → 성공

이제 다시 커밋하면 정상적으로 된다.

 

git commit -m "my first commit"

성공하면 아래 같은 메시지가 나온다.

 

[main (root-commit) ...] my first commit 1 file changed, 1 insertion(+) create mode 100644 README.md

---

5) push 할 때 브라우저 인증 뜨는 건 정상

원격 저장소(GitHub)로 처음 push할 때는 아래처럼 브라우저 인증을 요구할 수 있다.

 

git push -u origin main

출력 예:

 

info: please complete authentication in your browser... ... branch 'main' set up to track 'origin/main'.

이건 Git Credential Manager가 GitHub 로그인/권한을 연결하는 과정이라 정상이다.
브라우저에서 로그인/권한 승인만 하면 push가 완료된다.

---

6) 정리 (가장 중요한 핵심)

처음 커밋에서 Author identity unknown이 뜨면 거의 항상 이것만 하면 된다:

 

git config --global user.name "내이름"

git config --global user.email "내이메일"

Git