Git 커밋 작성자 정보 오류 수정: unknown/root 문제 해결 및 이력 관리 가이드

핵심 기술

이 콘텐츠는 Git 커밋 시 발생할 수 있는 작성자 정보 오류(unknown, root)를 해결하는 실질적인 방법을 제시하며, Git의 rebase와 git filter-repo를 활용한 커밋 히스토리 수정 과정을 상세히 안내합니다.

기술적 세부사항

• 문제 정의: Git 설정 누락 또는 환경 변경으로 인해 커밋 작성자 이름이 'unknown' 또는 'root'로 기록되는 현상.
• 문제 발생 원인:
  • WSL/도커 등 별도 환경에서 Git 설정(git config --global user.name, git config --global user.email) 미실행.
  • 새 컴퓨터에서 Git 초기 설정 미완료.
• 해결 방법 1: git rebase -i 활용 (불완전하지만 특정 커밋 수정 가능)
  • 수정할 브랜치로 이동 (git checkout <branch-name>).
  • git rebase -i <commit-hash>^ 명령으로 수정할 커밋 이전까지의 히스토리 편집 모드 진입.
  • pick을 edit으로 변경하여 해당 커밋에서 멈추게 함.
  • git commit --amend --author="<이름> <이메일>" 명령으로 작성자 정보 수정.
  • git rebase --continue로 다음 커밋으로 진행 (이 과정에서 이후 커밋들이 다시 작성되어 작성자 정보가 변경됨).
  • 로컬과 원격 히스토리가 달라지므로 git push origin <branch-name> --force로 강제 푸시.
  • 주의: 이 방법은 이후 커밋의 작성자도 함께 변경될 수 있으며, 원본 히스토리와 달라져 팀 협업 시 충돌이 발생할 수 있습니다.
• 해결 방법 2: git filter-repo 활용 (전체 히스토리 재작성)
  • git filter-repo --force --commit-callback "if commit.original_id == b'<commit-hash>': commit.author_name = b'<새이름>'; commit.author_email = b'<새이메일>'; commit.committer_name = b'<새이름>'; commit.committer_email = b'<새이메일>'" 명령으로 특정 커밋의 작성자 정보를 변경.
  • git push origin <branch-name> --force로 강제 푸시.
  • 주의: 이 방법은 모든 커밋 ID를 변경하므로, 팀 프로젝트에서는 반드시 팀원과 상의 후 사용해야 합니다.
• 충돌 해결: rebase 중 충돌 발생 시 git checkout --theirs . 등을 사용하여 충돌을 해결할 수 있습니다.

개발 임팩트

• Git 커밋 히스토리를 깔끔하게 관리하여 프로젝트의 투명성과 책임 소재를 명확히 할 수 있습니다.
• 협업 시 다른 팀원의 코드 기여 내용을 쉽게 파악하고, 프로젝트 참여 이력을 증명하는 근거 자료로 활용할 수 있습니다.
• Git의 고급 기능을 익혀 개발 생산성과 협업 효율성을 높일 수 있습니다.

커뮤니티 반응

(원문에서 특정 커뮤니티 반응은 언급되지 않았습니다.)

톤앤매너

이 글은 Git 사용 중 겪을 수 있는 실제적인 문제 해결 과정을 공유하며, 개발자의 입장에서 실질적인 도움을 줄 수 있도록 전문적이고 명확한 톤으로 작성되었습니다.