처음 개발환경을 세팅할 때 Git 설치가 꼬이면 이후 작업(클론/푸시/버전관리)이 연쇄로 막힙니다.
이 글은 2026년 기준으로 맥에서 가장 많이 쓰는 방법(권장: Homebrew)으로 Git 설치 2026을 끝내고,
바로 실무에서 필요한 초기 설정(user.name/user.email, 기본 브랜치, 줄바꿈)을 “검증까지” 마무리하는 흐름으로 구성했습니다.
1) Git 설치 전, 지금 내 맥에 Git이 있는지 먼저 확인
터미널에서 아래 2줄만 확인하세요. 이미 Git이 있어도 버전이 너무 낮거나(또는 Xcode 경로 이슈) 설정이 안 되어 있으면 다시 정리하는 게 빠릅니다.
git --version
which git
- git: command not found → 아직 Git이 설치되지 않았거나 PATH 문제
- /usr/bin/git → 보통 Xcode Command Line Tools 기반 Git
- /opt/homebrew/bin/git → (애플실리콘) Homebrew로 설치한 Git (권장)
2) Git 설치 3가지 방법 비교 (2026 권장 시나리오 포함)
| 방법 | 장점 | 단점 | 추천 대상 |
|---|---|---|---|
| Xcode Command Line Tools | 가장 간단(자동 설치) | 버전 업데이트가 느릴 수 있음 | 가벼운 사용/초기 확인용 |
| Homebrew (권장) | 업데이트/관리 쉬움, 최신 버전 유지 | Homebrew가 먼저 필요 | 대부분의 개발자(추천) |
| 공식 설치(pkg) | GUI 설치 가능 | 관리/업데이트가 번거로움 | 터미널이 익숙하지 않은 경우 |
3) (권장) Homebrew로 Git 설치하는 방법
2026 기준 맥 개발환경에서 가장 안정적으로 관리되는 흐름은 Homebrew → Git 설치입니다. 이미 Homebrew가 준비되어 있다면 아래 한 줄로 끝납니다.
brew install git
설치 후, 터미널을 새로 열고 버전/경로를 다시 확인하세요.
git --version
which git
- 애플 실리콘(M1~)이라면 보통
/opt/homebrew/bin/git경로가 나옵니다. - 인텔 맥이라면 보통
/usr/local/bin/git경로가 나옵니다.
4) Git 초기 설정 3종 세트: 이름/이메일, 기본 브랜치(main), 줄바꿈(LF/CRLF)
4-1) 커밋 작성자 정보(user.name / user.email)
Git 설치 후 가장 먼저 할 일입니다. 이 설정이 없으면 커밋이 꼬이거나, 협업에서 “누가 커밋했는지”가 애매해집니다. 아래 값은 본인 걸로 바꿔서 입력하세요.
git config --global user.name "홍길동"
git config --global user.email "you@example.com"
정상 반영 여부는 이렇게 확인합니다.
git config --global --list
4-2) 기본 브랜치를 main으로 고정(권장)
새 저장소를 만들 때 기본 브랜치가 master로 생성되는 환경이면 팀/문서/CI 설정이 엇갈릴 수 있습니다.
아래 설정으로 “새로 만드는 저장소”의 기본 브랜치를 main으로 통일하세요.
git config --global init.defaultBranch main
테스트로 새 폴더에서 init 해보고 확인합니다.
mkdir git-test && cd git-test
git init
git branch
4-3) 줄바꿈(LF/CRLF) 설정: 맥은 보통 input 권장
협업에서 가장 자주 터지는 게 “줄바꿈 차이”입니다. 맥/리눅스는 LF, 윈도우는 CRLF가 기본이라서, 설정 없이 섞이면 파일이 전부 수정된 것처럼 보일 수 있어요.
- 맥/리눅스 권장:
input(체크아웃은 LF 유지, 커밋 시 CRLF를 LF로 정규화) - 윈도우 권장:
true또는 팀 규칙에 맞춰 .gitattributes 사용
git config --global core.autocrlf input
현재 값 확인:
git config --global core.autocrlf
5) “Git 설치했는데 안 돼요” 자주 터지는 문제 5가지
5-1) git: command not found
- 터미널을 재실행(새 창) 후 다시
git --version - Homebrew 설치/경로 문제가 의심되면 위 Homebrew 글로 먼저 점검
5-2) which git이 /usr/bin/git로 찍혀요 (Homebrew로 설치했는데도)
이건 PATH 우선순위 문제인 경우가 많습니다. (특히 zsh 환경에서)
보통은 터미널 재실행로 해결되지만, 지속된다면 echo $PATH로 Homebrew 경로가 앞쪽에 있는지 확인하세요.
echo $PATH
5-3) 권한/Permission denied
설치 단계에서 권한 오류가 난다면, Homebrew 권한/소유권 문제일 가능성이 큽니다. Git 설치 문제처럼 보이지만 “원인”은 Homebrew 쪽인 경우가 많아서, 먼저 Homebrew 권한 해결을 끝내고 다시 진행하는 게 빠릅니다.
6) 설치/설정이 끝났는지 “1분 검증 체크리스트”
git --version
git config --global user.name
git config --global user.email
git config --global init.defaultBranch
git config --global core.autocrlf
- Git 설치가 정상이라면 버전이 출력됩니다.
- 이름/이메일이 비어 있지 않다면 커밋 준비 완료입니다.
- defaultBranch가 main이면 새 프로젝트에서 브랜치 혼선이 줄어듭니다.
7) 다음 단계(추천): GitHub 연동/SSH로 비밀번호 없이 push/pull
여기까지가 “로컬에서 Git을 제대로 쓰기 위한” 최소 세팅입니다. 다음은 GitHub 연결(특히 SSH)인데, 이걸 해두면 매번 비밀번호/토큰 입력 없이 push/pull이 됩니다.
0 댓글