Git을 설치하고 사용자 정보를 설정하는 전 과정을 실제 명령어와 함께 실습합니다. 맥북 기본 Git이 있더라도, 이 시리즈에서는 이후 관리와 업데이트를 쉽게 하기 위해 Homebrew 버전을 기준으로 진행합니다.
이번 글은 교무실에서 새 업무용 도구를 설치하고, 문서에 찍힐 이름표와 서명 정보를 등록하는 과정과 비슷합니다. 한 번만 제대로 해 두면 다음 글부터는 저장소를 만들고 커밋할 때 그 정보가 자동으로 기록됩니다.
필요한 것:
소요 시간: 약 5분
이전 가이드: Git 시리즈 1편: Git이 뭔가요?
이미 설치되어 있다면 Homebrew가 재설치 대신 최신 상태 여부만 알려줍니다. git --version에서 버전 숫자가 보이면 설치 확인은 끝입니다.
💡 참고: 맥북 기본 Git이 있더라도, 학습 흐름은 brew install git 기준으로 맞춰 두는 편이 이후 설명과 재설치가 훨씬 깔끔합니다.
Git은 누가 변경했는지 기록하기 위해 사용자 정보가 필요합니다. 문서 결재란에 작성자 이름과 이메일이 남는 것처럼, 커밋에도 작성자 정보가 함께 저장됩니다.
Git 커밋 기록에 남을 작성자 이름을 먼저 저장합니다. 실명, 닉네임, 영문 이름 중 무엇을 써도 되지만 나중에 본인이 알아볼 수 있는 이름이 좋습니다.
이어서 같은 방식으로 이메일도 저장합니다. GitHub와 연결해 사용할 예정이라면 GitHub 계정에 등록된 이메일 주소 중 하나를 쓰는 것이 가장 헷갈리지 않습니다.
처음 두 명령어는 아무것도 출력되지 않으면 정상 저장된 것입니다. 마지막 git config --list에서 user.name과 user.email이 보이면 설정이 들어간 것입니다.
⚠️ 중요: GitHub에 커밋을 내 계정 활동으로 표시하고 싶다면 GitHub 계정에 등록된 이메일 주소 중 하나로 설정하세요. 가입 이메일과 달라도, GitHub 계정에 추가해 둔 이메일이면 연결될 수 있습니다.
방금처럼 git config --list로 저장된 값을 바로 확인할 수 있습니다.
Git에서 텍스트 입력이 필요할 때, 예를 들어 긴 커밋 메시지를 작성할 때 열릴 에디터를 설정합니다. 입문 단계에서는 nano가 비교적 단순합니다. 나중에 VS Code를 자주 쓰게 되면 code --wait으로 바꿔도 됩니다.
새 저장소를 만들 때 기본 브랜치 이름을 main으로 설정합니다. main은 업무 파일철의 기본 묶음 이름이라고 생각하면 됩니다. 특별히 나누기 전에는 대부분의 작업이 이 기본 묶음에서 시작합니다.
설정이 파일에 어떻게 저장되었는지 직접 확인하면 더 잘 이해됩니다. ~/.gitconfig는 내 컴퓨터 전체 Git 설정이 적힌 개인 설정표입니다.
설정 완료 테스트:
핵심 명령어 정리:
| 명령어 | 설명 | 사무/교무실 비유 |
|---|---|---|
git --version |
버전 확인 | 설치된 도구 모델명 확인 |
git config --global user.name "이름" |
이름 설정 | 문서 작성자 이름표 등록 |
git config --global user.email "이메일" |
이메일 설정 | 작성자 연락처 등록 |
git config --list |
설정 목록 확인 | 등록된 설정표 확인 |
설치와 전역 설정은 내 컴퓨터 전체에 영향을 줍니다. AI에게 바로 실행시키지 말고, 먼저 확인과 제안을 요청하세요.
Git 설치 여부와 현재 git config --global 설정을 확인해줘.
설치나 설정 변경 명령은 제안만 하고, 내가 허락하기 전에는 실행하지 마.
Git 커밋용 user.name, user.email, 기본 에디터, 기본 브랜치 설정을 도와줘.
이메일은 GitHub 계정에 등록된 이메일이어야 한다고 설명하고, 변경 전 적용할 명령어를 먼저 보여줘.
설정이 꼬였을 때도 삭제부터 시키지 마세요. “~/.gitconfig를 바로 지우지 말고 현재 설정을 보여준 뒤 백업 방법을 제안해줘”라고 요청하는 편이 안전합니다.
해결:
brew install git
해결:
# ~/.gitconfig 파일 권한 확인
ls -la ~/.gitconfig
# 파일이 없으면 직접 생성
touch ~/.gitconfig
해결:
git config --global user.email "새이메일@example.com"
잘못된 예:
git config --global user.name 홍 길 동 # 오류!
올바른 예:
git config --global user.name "홍 길 동"
해결:
# 특정 설정 삭제
git config --global --unset user.name
# 전체 설정을 바로 지우기보다 백업해 두기
mv ~/.gitconfig ~/.gitconfig.backup
완료 기준:
git --version으로 Git 설치 확인user.name 설정 완료user.email 설정 완료git config --list로 설정 확인~/.gitconfig 파일 확인설정 과정 요약:
git --version
git config --global user.name "홍길동"
git config --global user.email "[email protected]"
git config --global core.editor nano
git config --global init.defaultBranch main
git config --list
cat ~/.gitconfig
추천 다음 단계:
Git 설치와 기본 설정을 완료하셨다면, 이제 실제 저장소를 만들고 첫 커밋을 해봅시다.
Git 시리즈 3편: 저장소 만들고 첫 커밋하기에서는 git init으로 저장소를 만들고, git add와 git commit으로 첫 버전을 기록하는 방법을 실습합니다.
💬 댓글
이 글에 대한 의견을 남겨주세요