Git 기본 사용법 — 평생 쓰는 명령 15개와 멘탈 모델

[작업 디렉토리] → [스테이지] → [로컬 저장소] → [원격 저장소]
  Working Dir      Staging       Repository       Remote
  (수정 중)       (찍어둠)      (내 컴퓨터)      (GitHub 등)

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
 
# 기본 브랜치 이름을 main으로 (옛날 git은 master)
git config --global init.defaultBranch main
 
# 줄바꿈 문제 (Mac/Linux)
git config --global core.autocrlf input
 
# 자주 쓰는 별칭 (선택)
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch

git config --list

mkdir my-project
cd my-project
git init

git clone https://github.com/user/repo.git
git clone https://github.com/user/repo.git my-folder-name  # 폴더명 바꿔서

git status

git status -s   # 짧게
git status -sb  # 짧게 + 브랜치 정보

git add file.txt           # 한 파일
git add src/               # 폴더 안의 모든 변경
git add .                  # 현재 폴더 아래 전부
git add -A                 # 저장소 전체
git add -p                 # 파일 안에서 부분만 선택해서 (강력함)

git commit -m "feat: add login flow"

git commit  # 에디터가 열림. 첫 줄 제목, 빈 줄, 본문.

git commit -am "..."   # add + commit 한 번에 (이미 추적 중인 파일만)
git commit --amend     # 마지막 커밋 메시지/내용 수정 (아직 push 안 했을 때만)

git log                          # 전체
git log --oneline                # 한 줄씩
git log --oneline --graph        # 브랜치 그림까지
git log --oneline --graph --all  # 모든 브랜치 다
git log -p                       # 변경 내용까지
git log -5                       # 최근 5개
git log --author="kim"           # 특정 사람
git log --since="1 week ago"     # 특정 기간

git log --oneline --graph --all -20

git diff              # 작업 디렉토리 vs 스테이지 (아직 add 안 한 변경)
git diff --staged     # 스테이지 vs 마지막 커밋 (add는 했지만 commit 안 한 변경)
git diff HEAD         # 작업 디렉토리 vs 마지막 커밋 (전부)
git diff main feature # 브랜치 간 차이
git diff abc123 def456 # 특정 커밋 간 차이

# 의존성
node_modules/
.venv/
__pycache__/
 
# 빌드 산출물
dist/
build/
.next/
 
# 환경 변수 (절대!)
.env
.env.local
.env.*.local
 
# OS
.DS_Store
Thumbs.db
 
# 에디터
.vscode/
.idea/
*.swp

git branch                    # 브랜치 목록
git branch feature/login      # 새 브랜치 만들기 (안 옮김)
git switch feature/login      # 브랜치 옮기기
git switch -c feature/login   # 만들고 바로 옮기기 (자주 씀)
git switch main               # main으로 돌아가기
git branch -d feature/login   # 브랜치 삭제 (이미 머지됨)
git branch -D feature/login   # 강제 삭제 (안 머지됐어도)

git switch main            # main에서 시작
git pull                   # 최신 상태로
git switch -c feature/x    # 새 브랜치 만들고 옮기기
# ... 작업 ...
git add . && git commit -m "feat: ..."
git push -u origin feature/x  # 원격에 첫 push

git switch main         # 받을 브랜치로 옮기고
git merge feature/login # feature/login의 변경을 main에 합침

<<<<<<< HEAD
const port = 3000;
=======
const port = 8080;
>>>>>>> feature/login

git merge --abort

git pull            # 원격 변경을 가져와서 내 브랜치에 머지
git push            # 내 변경을 원격으로 올림
git push -u origin feature/x  # 첫 push (브랜치 연결)
git fetch           # 원격 정보만 가져오고 머지는 안 함 (안전한 pull)

git fetch
git log --oneline ..origin/main  # 원격에 어떤 새 커밋이 있는지 보기
git pull                          # 괜찮으면 머지

git restore file.txt          # 작업 디렉토리의 변경을 버림
git restore --staged file.txt # 스테이지에서 내림 (add 취소)
git restore .                 # 모든 변경 다 버림 (위험!)

git reset --soft HEAD~1   # 커밋만 취소, 변경은 스테이지에 남김
git reset HEAD~1          # 커밋도 취소, 스테이지도 비움, 변경은 작업 디렉토리에
git reset --hard HEAD~1   # 다 날림 (커밋, 스테이지, 작업 디렉토리)

git reset --hard abc123

git revert abc123

# 시나리오: 어제 푸시한 버그 커밋을 되돌려야 함
git revert HEAD              # 마지막 커밋의 반대 커밋을 만듦
git push                     # 안전하게 올림

git stash              # 현재 변경을 임시 보관, 작업 디렉토리는 깨끗해짐
git stash list         # 보관된 것들 목록
git stash pop          # 가장 최근 stash를 꺼내서 적용 + 목록에서 삭제
git stash apply        # 꺼내서 적용만 (목록엔 남김)
git stash drop         # 목록에서 버림
git stash -u           # 추적 안 되는 파일까지 함께

# 작업 중인데 main에 핫픽스 해달라고 함
git stash
git switch main
# ... 핫픽스 ...
git switch feature/x
git stash pop

git reflog

git reset --hard abc123  # 그 시점으로 돌아가기

git branch recovered abc123

# 아침 — 최신 상태로 시작
git switch main
git pull
 
# 새 작업 시작
git switch -c feature/something
 
# 한 사이클 (수십 번 반복)
# ... 코드 작성 ...
git status                    # 뭐가 바뀌었나
git diff                      # 어떻게 바뀌었나
git add -p                    # 의미 단위로 골라서
git diff --staged             # 올라간 거 다시 확인
git commit -m "feat: ..."
 
# 원격에 올리기
git push -u origin feature/something
 
# 다 끝나면
git switch main
git merge feature/something   # 또는 PR을 통해
git branch -d feature/something

git rm --cached .env              # 추적에서 제거
echo ".env" >> .gitignore         # 무시 목록에 추가
git commit -m "chore: untrack .env"
# 그리고 노출된 모든 시크릿을 즉시 교체

git commit --amend -m "올바른 메시지"  # push 전이면 OK

git pull   # 머지하고
git push   # 다시

# main에서 시작했어야 하는데 feature/old에서 시작함
git switch feature/new
git rebase --onto main feature/old
# 어렵다면 그냥 변경 복사해서 새로 시작

git reflog       # 모든 움직임 기록을 봄
git reset --hard <잃어버린 해시>