GitHub 완전 정복 7편 — rebase -i, cherry-pick, bisect와 히스토리를 다루는 도구들

git rebase -i HEAD~5        # 최근 5개 커밋 편집
git rebase -i abc1234       # 특정 커밋 이후 전부
git rebase -i --root        # 최초 커밋부터

pick abc1234 feat: 로그인 폼
squash def5678 fix: 오타
reword ghi9012 feat: 인증 로직
drop jkl3456 wip
edit mno7890 refactor: 정리

git commit --fixup=abc1234       # "fixup! ..." 커밋 생성
git rebase -i --autosquash HEAD~5  # 자동으로 제자리에 배치

git cherry-pick abc1234              # 커밋 1개 가져오기
git cherry-pick abc1234 def5678      # 여러 개
git cherry-pick abc1234..def5678     # 범위 (abc 제외)
git cherry-pick -n abc1234           # 커밋 없이 스테이징만
git cherry-pick -x abc1234           # 원본 해시를 메시지에 기록 ★
git cherry-pick --abort              # 취소 ★

git bisect start
git bisect bad                  # 현재는 버그 있음
git bisect good v1.0.0          # 이 버전은 멀쩡했음
# → Git이 중간 커밋으로 이동시킴
 
# 테스트 후
git bisect good     # 또는 git bisect bad
# → 반복
 
git bisect reset    # 종료, 원래 위치로 ★

git bisect start HEAD v1.0.0
git bisect run npm test      # 테스트 스크립트가 exit 0 = good, 그 외 = bad
# → 커피 마시고 오면 범인 커밋이 나와 있음

git worktree add ../hotfix hotfix/urgent    # 새 폴더에 브랜치 체크아웃
git worktree add -b feature/new ../new      # 브랜치 생성과 동시에
git worktree list                           # 목록
git worktree remove ../hotfix               # 제거
git worktree prune                          # 정리

git submodule add https://github.com/user/lib.git libs/lib
git submodule update --init --recursive     # 클론 후 필수 ★
git clone --recurse-submodules <url>        # 한 번에
git submodule update --remote               # 최신으로 갱신

git subtree add --prefix=libs/lib https://github.com/user/lib.git main --squash
git subtree pull --prefix=libs/lib https://github.com/user/lib.git main --squash
git subtree push --prefix=libs/lib https://github.com/user/lib.git main

# 얕은 클론 — 최근 커밋만 (CI에서 매우 유용)
git clone --depth 1 <url>
git fetch --unshallow          # 나중에 전체 히스토리 받기
 
# 특정 브랜치만
git clone --single-branch --branch main <url>
 
# 필요한 디렉토리만 체크아웃
git clone --filter=blob:none --sparse <url>
cd repo
# Git 2.37부터 cone 모드가 기본값이라 --cone은 붙이지 않아도 됩니다(그 아래 버전에서는 필요합니다).
git sparse-checkout set src/ docs/
git sparse-checkout list
git sparse-checkout disable

git lfs install
git lfs track "*.psd"
git lfs track "*.mp4"
git add .gitattributes         # 반드시 커밋할 것 ★
git lfs ls-files

# 1순위 — 키를 즉시 폐기하고 재발급 ★★★
# 히스토리를 지워도 누군가 이미 clone/fork 했을 수 있습니다
 
# 2순위 — 히스토리 정리 (Git 공식 문서가 filter-branch 사용을 권장하지 않고 git-filter-repo를 안내합니다)
pip install git-filter-repo
 
# filter-repo는 "갓 clone한 사본"이 아니면 실행 자체를 거부합니다. HEAD reflog 항목이 2개 이상이면 걸리므로
# 한 번이라도 커밋하고 push한 작업 저장소는 거의 전부 해당됩니다. 그래서 새로 clone한 사본에서 시작합니다.
# 에러 메시지가 안내하는 --force는 이 안전장치를 끄는 옵션입니다. 따로 백업해 둔 사본이 아니면 붙이지 마세요.
git clone https://github.com/user/repo.git repo-clean
cd repo-clean
git filter-repo --path .env --invert-paths          # 파일 제거
git filter-repo --replace-text secrets.txt          # 문자열 치환
 
# 3순위 — 강제 푸시 (팀 전원에게 사전 공지 필수 ⚫)
# filter-repo는 실수로 되밀지 못하게 origin을 지웁니다. 다시 등록하고 fetch부터 해야 합니다.
git remote add origin https://github.com/user/repo.git
git fetch origin
# 히스토리를 통째로 다시 쓴 직후에는 --force-if-includes가 반드시 거부합니다(원격의 옛 끝점이
# 새 히스토리에 통합된 적이 없기 때문). 이 한 번은 --force-with-lease까지만 붙입니다.
git push --force-with-lease --all
git push --force-with-lease --tags

# Node.js — husky + lint-staged
npm install -D husky lint-staged
npx husky init
echo "npx lint-staged" > .husky/pre-commit   # init이 만들어둔 기본 내용(npm test)을 덮어씁니다

{
  "lint-staged": {
    "*.{ts,tsx}": ["eslint --fix", "prettier --write"],
    "*.{json,md}": ["prettier --write"]
  }
}

# 언어 무관 — pre-commit (Python 기반)
pip install pre-commit
pre-commit install

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v6.0.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-added-large-files
      - id: detect-private-key      # 키 커밋 방지 ★