Git은 무엇인가
- 분산 버전 관리 시스템(Distributed VCS). 스냅샷(커밋) 단위로 코드 이력을 관리하고, 브랜치를 기반으로 안전하게 실험·협업한다.
핵심 개념
- 워킹 디렉토리/스테이징/리포지토리: 수정 →
git add(스테이징) → git commit(저장)
- 커밋/브랜치/태그: 스냅샷과 포인터.
HEAD는 현재 체크아웃한 커밋/브랜치를 가리킴
- 원격(remote):
origin 등 서버 저장소. fetch/pull/push로 동기화
자주 쓰는 명령 모음
# 초기화/복제
git init
git clone <repo-url>
# 상태/이력/차이
git status
git log --oneline --graph --decorate --all
git diff # 워킹 vs 스테이징
git diff --staged # 스테이징 vs 마지막 커밋
# 스테이징/커밋
git add -p # 청크 단위 선택적 스테이징
git commit -m "feat: add user login"
# 브랜치 생성/이동/병합
git switch -c feat/login
git switch main
git merge feat/login # 병합 커밋
git rebase main # 선형 이력 만들기(로컬에서 신중히)
# 원격 동기화
git fetch # 원격 참조만 갱신
git pull --rebase # 가져오며 로컬 위에 재배치
git push -u origin HEAD
# 임시 저장
git stash push -m "wip: refactor"
git stash pop
# 되돌리기
git restore <file> # 워킹 디렉토리 되돌리기
git reset --mixed HEAD~1 # 마지막 커밋 취소+스테이징 해제(로컬 정리)
git reset --hard HEAD~1 # 강제 되돌림(주의)
git revert <commit> # 공개 이력에서 안전한 되돌리기
브랜치 전략(협업)
- Trunk-based(추천): 보호된
main + 작은 기능 브랜치(PR). 빠른 병합·짧은 피드백 루프
- Git Flow:
develop/release/hotfix가 분리된 큰 팀/릴리스 주기 긴 프로젝트에 적합
- 공통 원칙: 작은 PR, 명확한 커밋 메시지(Conventional Commits), 필수 리뷰/CI
충돌 관리 베스트 프랙티스
- 자주 fetch/rebase해 변경을 작게 유지
- 파일 단위가 아닌 청크/함수 단위로 수정 범위를 최소화
- 도구 활용: IDE 머지 도구,
git mergetool
- 해결 후:
git add → 테스트 통과 확인 → git rebase --continue 또는 커밋
되돌리기 선택 가이드
- 로컬 정리:
git reset(mixed/hard)
- 공개 이력:
git revert로 역커밋 생성(히스토리 보존)
- 실수 방지: 강제 푸시는 최소화, 보호 브랜치 정책 활용
품질과 자동화
.gitignore 정리로 불필요 파일 제외- 커밋 훅(Husky)으로 린트/테스트 자동화, CI에서 빌드·테스트 강제
git bisect로 회귀 버그를 이분 탐색
마무리
- 작은 단위의 커밋/PR, 일관된 전략, 안전한 되돌리기 습관이 협업 생산성을 좌우한다. 팀 규모와 릴리스 주기에 맞춰 Trunk-based 또는 Git Flow를 선택하고, 자동화로 품질을 보장하자.