🔀
Git 치트시트

커밋, 브랜치 관리, 스태시, 원격 동기화, cherry-pick(체리픽), reset/revert 되돌리기 마법 명령어
#git#github#vcs#branch#commit#stash#rebase#cherry-pick최종 업데이트: 2026-09-30
Git 치트시트 핵심 명령어 및 실전 가이드

커밋, 브랜치 관리, 스태시, 원격 동기화, cherry-pick(체리픽), reset/revert 되돌리기 마법 명령어
## 1. 초기화 및 전역 설정
```bash
# 사용자 이름과 이메일 전역 설정
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# 기본 브랜치명을 main으로 설정
git config --global init.defaultBranch main

# 현재 적용된 전체 설정 확인
git config --list --show-origin
```
새로운 환경에서 Git을 처음 시작할 때 필수로 지정해야 하는 기본 설정입니다.

## 2. 저장소 생성 및 복제
```bash
# 현재 디렉토리에 새로운 Git 저장소 초기화
git init

# 원격 저장소 복제 (특정 브랜치만 복제 시 -b 옵션)
git clone https://github.com/user/repo.git
git clone -b develop --single-branch https://github.com/user/repo.git
```
기존 프로젝트를 가져오거나 신규 저장소를 시작할 때 사용합니다.

## 3. 스테이징 및 커밋
```bash
# 변경된 모든 파일 스테이징
git add .

# 변경 사항 일부만 대화형으로 스테이징 (강력 추천)
git add -p

# 메시지와 함께 커밋
git commit -m "feat: 사용자 로그인 API 구현"

# 직전 커밋 메시지 또는 빠뜨린 파일 수정 (amend)
git commit --amend --no-edit
```
`git add -p`를 사용하면 변경된 청크(hunk) 단위로 코드를 검토하며 스테이징할 수 있어 커밋이 깔끔해집니다.

## 4. 상태 및 변경 사항 비교
```bash
# 간결한 한 줄 상태 요약
git status -s

# 작업 디렉토리의 변경 사항 비교 (아직 스테이징 안 된 내용)
git diff

# 스테이징된 변경 사항 비교
git diff --staged

# 특정 커밋 간의 변경 내역 요약
git diff --stat HEAD~1 HEAD
```

## 5. 브랜치 관리 및 전환
```bash
# 브랜치 목록 확인 (원격 포함)
git branch -a

# 새 브랜치 생성 및 즉시 전환 (현대적인 switch 명령)
git switch -c feature/auth-flow

# 이전 브랜치로 빠르게 되돌아가기
git switch -

# 브랜치 삭제 (병합 완료 / 강제 삭제)
git branch -d feature/old
git branch -D feature/discard
```

```mermaid
gitGraph
  commit id: "init"
  commit id: "v1.0"
  branch feature
  checkout feature
  commit id: "feat-auth"
  commit id: "feat-ui"
  checkout main
  merge feature id: "merge"
  commit id: "deploy"
```

Astro와 최신 Git에서는 구식 `checkout` 대신 `switch`와 `restore`를 사용하는 것이 안전하고 권장됩니다.

## 6. 원격 저장소 동기화 & 푸시
```bash
# 원격 저장소 최신 커밋 가져오기 (병합 없이)
git fetch origin

# 원격 변경사항을 현재 브랜치 위로 깔끔하게 rebase 풀
git pull --rebase origin main

# 새 브랜치를 원격에 업스트림 추적 설정하며 푸시
git push -u origin feature/auth-flow

# 강제 푸시 시 다른 사람의 커밋 덮어쓰기 방지 (안전한 force-with-lease)
git push --force-with-lease
```
`--force-with-lease`는 일반 `-f`보다 훨씬 안전하게 원격 변경 충돌을 감지해 줍니다.

## 7. 임시 작업 저장 (Stash)
```bash
# 추적되지 않는(untracked) 파일까지 함께 임시 보관
git stash -u -m "로그인 임시 작업"

# 스태시 보관 목록 확인
git stash list

# 가장 최근 스태시 복원 후 목록에서 삭제
git stash pop

# 특정 스태시 내용 확인 (적용하지 않고 내용만 미리보기)
git stash show -p stash@{0}
```

## 8. 되돌리기 & 실행 취소 (Undo & Reset)
```bash
# 특정 파일의 수정을 최신 커밋 상태로 되돌리기
git restore <file-path>

# 스테이징된 파일을 작업 디렉토리로 되돌리기 (unstage)
git restore --staged <file-path>

# 최근 커밋을 취소하고 변경 파일은 그대로 남겨두기 (Soft Reset)
git reset --soft HEAD~1

# 특정 커밋의 변경을 반대로 수행하는 안전한 취소 커밋 생성
git revert <commit-hash>
```

## 9. 아름다운 로그 그래프 확인
```bash
# 커밋 히스토리를 한눈에 볼 수 있는 터미널 그래프
git log --graph --oneline --decorate --all

# 최근 5개의 커밋과 변경 파일 통계 표시
git log -n 5 --stat
```
터미널에서 브랜치 분기와 병합 흐름을 가장 빠르게 파악하는 명령어입니다.

## 10. 유용한 비상 탈출 명령어
```bash
# 실수로 삭제한 커밋/브랜치 살리기 (모든 HEAD 이동 기록 조회)
git reflog

# 병합 또는 리베이스 충돌 중 중단하고 이전으로 복구
git merge --abort
git rebase --abort

# 파일별 누가 어떤 라인을 언제 수정했는지 확인
git blame -L 10,25 path/to/file.ts
```
`git reflog`는 실수로 브랜치를 날렸거나 `reset --hard`를 했을 때 커밋 해시를 찾아 되살릴 수 있는 구원투수입니다.

## 11. 특정 커밋 쏙 골라오기 (Cherry-Pick)
```bash
# [1] 다른 브랜치의 특정 커밋 하나만 현재 브랜치로 가져와 커밋
git cherry-pick <commit-hash>

# [2] 커밋을 생성하지 않고 변경 내용만 워킹트리/스테이지에 반영 (-n, --no-commit)
# 여러 커밋의 변경사항을 검토하거나 하나로 묶어 커밋하고 싶을 때 매우 유용
git cherry-pick -n <commit-hash>

# [3] 여러 개의 개별 커밋 한 번에 가져오기 (공백 구분)
git cherry-pick <hash-A> <hash-B> <hash-C>

# [4] 특정 커밋 범위(A 다음부터 B까지) 연속 가져오기 (A 미포함)
git cherry-pick <commit-A>..<commit-B>

# [5] 특정 커밋 범위(A부터 B까지) 모두 가져오기 (A 포함)
git cherry-pick <commit-A>^..<commit-B>

# [6] 체리픽 중 충돌(Conflict) 발생 시 해결 워크플로우
# 1) 충돌 파일 수동 해결 후 스테이징
git add <resolved-file>
# 2) 체리픽 계속 진행
git cherry-pick --continue
# 3) 현재 커밋은 건너뛰고 다음 체리픽 진행
git cherry-pick --skip
# 4) 체리픽을 중단하고 체리픽 시작 전 상태로 완전 복원
git cherry-pick --abort

# [7] 머지 커밋(Merge Commit) 체리픽 시 부모 브랜치 번호 지정 (-m)
# 머지 커밋은 부모가 2개이므로 기준 부모(보통 1: 타겟 브랜치 방향)를 명시해야 함
git cherry-pick -m 1 <merge-commit-hash>
```
다른 브랜치에서 이미 구현된 핫픽스(버그 수정)나 특정 기능 커밋만 골라서 현재 릴리즈 브랜치로 이식할 때 가장 유용한 명령어입니다.
💬
Git 치트시트

의견 및 질문

댓글 수정

댓글 삭제
