Git rebase 실습: merge와 차이 · interactive rebase · squash · fixup

핵심 원리

rebase는 commit의 부모를 바꾸고 새 commit을 만드는 history rewrite입니다. local 정리에는 유용하지만 이미 공유한 commit을 바꿀 때는 팀원의 branch와 충돌할 수 있습니다.

Git에서는 현재 상태를 모른 채 강한 명령부터 실행하지 않습니다. 작업 전에는 status와 branch를 확인하고, history를 바꾸는 작업이라면 log와 reflog까지 확인합니다.

공유하지 않은 branch의 이력 정리

이 실습은 다른 사람이 기반으로 사용하지 않고 아직 push하지 않은 feature branch에서 수행합니다. main에 직접 적용하지 않습니다. clean 상태에서 feature/rebase-demo를 만들고 README의 작은 변경을 세 번 나누어 commit합니다. 각 commit은 파일을 실제로 수정한 뒤 add와 commit을 실행해 만듭니다.

git switch main
git switch -c feature/rebase-demo

세 commit을 만든 다음 log에서 대상 세 개를 확인합니다. 안전한 비교 기준으로 branch를 하나 보존할 수 있습니다. 이름이 이미 있으면 재사용하지 않습니다.

git status --short
git log --oneline -4
git branch backup/rebase-demo
git rebase -i HEAD~3

편집기에서 첫 commit은 pick으로 남기고 두 번째는 squash 또는 fixup으로 첫 commit에 합치며 세 번째는 pick으로 유지하면 세 commit을 두 개로 정리할 수 있습니다. squash는 메시지를 편집하고 fixup은 합쳐지는 commit의 메시지를 버립니다. drop은 변경을 제외하므로 이번 실습에서는 선택하지 않습니다. 저장·종료 뒤 diff와 log로 최종 파일 내용이 유지됐는지 확인합니다.

git log --graph --oneline --decorate -6
git diff backup/rebase-demo HEAD

내용 변경 없이 이력만 정리했다면 마지막 diff는 비어 있어야 합니다. 최신 main 위로 재배치할 필요가 있으면 fetch 후 feature branch에서 다음을 선택합니다.

git fetch origin
git rebase origin/main

충돌한 경우에만 파일을 편집하고 해당 파일을 add한 뒤 git rebase --continue를 실행합니다. 작업을 포기하려면 진행 중인 rebase에서 --abort를 선택합니다. 성공 후 --continue와 --abort를 연속 실행하는 절차가 아닙니다. rebase에서 ours/theirs의 의미를 일반 merge와 기계적으로 동일시하지 않습니다.

이미 공유한 branch의 이력 재작성은 별도 합의가 필요합니다. --force-with-lease는 원격의 예상 상태를 검사하지만 무조건 안전한 강제 push가 아닙니다. 백그라운드 fetch 등의 영향과 다른 사용자의 작업을 확인해야 하며, 본 실습은 강제 push 없이 로컬 비교로 완료합니다.

공식 근거: https://git-scm.com/docs/git-rebase · https://git-scm.com/docs/git-push

실습에서 확인할 것

WIP commit 여러 개가 있는 feature branch를 interactive rebase로 의미 있는 2개 commit으로 정리합니다.
main 최신 commit 위로 rebase 후 로그 그래프를 비교합니다.

다음 세 가지를 구분해서 기록합니다.

관찰
- Git이 현재 보여 주는 상태

판단
- 왜 이런 상태가 되었는지

조치
- 상태를 바꾸기 위해 선택한 최소 명령

이 순서를 유지하면 명령이 실패했을 때 원인을 추적하기 쉽고, 성공했더라도 무엇이 실제로 바뀌었는지 설명할 수 있습니다.

git status --short
git log --oneline -4
git branch backup/rebase-demo
git rebase -i HEAD~3

독립 학습 변형 과제: squash 전후 git diff 기준점..HEAD가 같아도 commit ID와 개수가 달라지는 이유를 설명합니다. 공유 이력에는 이 연습을 적용하지 않습니다.

git-step-07-context-switch

git status --short
git log --oneline --decorate -8

git branch -vv
git remote -v

# git-step-08-rebase 문서 체크포인트

이 ZIP은 Git·GitHub 실습 안내와 관련 설정 파일을 모은 자료입니다. `.git` 이력, 실제 branch/tag/stash/worktree, 원격 저장소, 사용자 계정이나 TaskFlow 앱 전체를 포함하지 않습니다. 별도의 개발환경 과정 TaskFlow 프로젝트에서 실습 안내를 읽고 명령을 단계별로 적용하세요. 이 폴더 자체를 완성된 Git 저장소로 간주하거나 명령을 한꺼번에 실행하지 마세요.

01~13 필수 과정의 이 회차까지 문서를 누적합니다.

검증 범위는 명령 문법·설정 형식·공식 문서 및 기존 프로젝트 스크립트 대조입니다. 실제 init/commit/branch/stash/worktree/reset/rebase/merge/push/PR/Release/서명 작업을 수행했다는 기록이 아닙니다. 개인 키·토큰·비밀번호는 포함하지 않습니다.

# Git·GitHub 01 실습 안내

이 파일은 독자가 상태를 확인하며 따라갈 Markdown 문서입니다. 자동 실행 스크립트나 검수 과정에서 실행한 Git 이력 로그가 아닙니다.

## 첫 저장소부터 원격 연결까지

Git 공식 설치 안내에서 운영체제에 맞는 Git을 설치합니다. Windows 명령 예제는 Git Bash 기준입니다. 이후 회차도 같은 셸을 사용합니다. 먼저 개발환경 과정에서 만든 TaskFlow 폴더를 편집기로 열고 그 폴더에서 터미널을 엽니다. 이미 .git이 있는 프로젝트라면 아래 init을 반복하기보다 현재 이력과 브랜치를 먼저 확인합니다.

```bash
git --version
git init -b main
git status --short
```

이름과 이메일은 이 저장소의 commit 작성자 정보입니다. GitHub 인증 비밀번호가 아닙니다. 공개 이메일을 원하지 않으면 GitHub Settings의 Emails에서 본인의 noreply 주소를 확인합니다. 아래 입력은 실제 값을 화면에 재출력하지 않고 저장소 로컬 설정에만 기록합니다.

```bash
read -r -p "commit 작성자 이름: " GIT_AUTHOR_LABEL
read -r -p "commit 작성자 이메일 또는 본인 noreply 주소: " GIT_AUTHOR_MAIL
if [ -n "$GIT_AUTHOR_LABEL" ] && [ -n "$GIT_AUTHOR_MAIL" ]; then
  git config --local user.name "$GIT_AUTHOR_LABEL"
  git config --local user.email "$GIT_AUTHOR_MAIL"
else
  printf '%s\n' '빈 작성자 정보로 진행하지 않습니다.'
fi
```

편집기에서 README.md에 TaskFlow의 목적 한 줄을 작성합니다. 기존 파일은 덮어쓰지 않고 내용을 읽고 수정합니다. .gitignore에는 기존 개발환경의 node_modules, 빌드 산출물, 실제 환경변수 파일 제외 규칙을 유지합니다. 첫 commit은 README만 명시적으로 선택합니다.

```bash
git status --short
git add README.md
git diff --cached
git commit -m "docs: describe TaskFlow"
git log --oneline -1
```

처음에는 README가 untracked라서 일반 git diff에 나오지 않을 수 있습니다. add 후 cached diff는 첫 commit에 들어갈 내용을 보여 줍니다. 이제 README에 실행 방법 한 줄을 추가해 add하고, commit하기 전에 다른 설명 한 줄을 더 수정합니다.

```bash
git add README.md
git status --short
git diff
git diff --cached
```

이때 예상하는 MM의 첫 M은 staging, 두 번째 M은 staging 이후 작업 트리 변경입니다. 두 diff를 비교한 뒤 두 변경 모두 포함하려면 다시 add하고 두 번째 commit을 만듭니다.

```bash
git add README.md
git diff --cached
git commit -m "docs: add TaskFlow usage"
```

GitHub에서는 본인 계정에 빈 저장소를 만들고 README나 초기 commit을 추가하지 않습니다. 저장소 화면의 HTTPS 또는 SSH 주소를 복사합니다. HTTPS는 Git Credential Manager 등 공식 인증 흐름을, SSH는 이미 등록한 키를 사용합니다. 비밀번호나 토큰을 URL에 넣지 않습니다. 아래는 독자가 본인 원격 저장소를 연결할 때 실행하는 절차이며 이 글의 검수에서 push한 결과가 아닙니다.

```bash
read -r -p "본인의 빈 GitHub 저장소 clone 주소: " TASKFLOW_REMOTE
if [ -n "$TASKFLOW_REMOTE" ]; then
  git remote add origin "$TASKFLOW_REMOTE"
else
  printf '%s\n' '원격 주소가 없어 연결하지 않습니다.'
fi
git remote -v
```

origin이 이미 존재하면 add 실패를 무시하지 말고 기존 주소가 본인의 대상인지 확인합니다. 주소와 commit 내용을 검토한 뒤에만 첫 push를 실행합니다.

```bash
git push -u origin main
git status -sb
git rev-parse HEAD
git ls-remote origin refs/heads/main
```

마지막 두 출력의 commit ID가 같고 GitHub 파일 화면이 일치하면 첫 연결 기준을 충족합니다. 빈 원격이 아니어서 rejected가 발생했다면 강제 push하지 않고 4편의 fetch/이력 비교로 이동합니다. init 전에는 status가 실패하고 첫 commit 전에는 log가 실패하는 것이 정상일 수 있습니다.

공식 근거: https://git-scm.com/docs/git-init · https://git-scm.com/docs/git-add · https://git-scm.com/docs/git-commit · https://docs.github.com/en/get-started/git-basics/set-up-git

## 체크포인트 기준

git-step-01-first-push: 위 실습의 관찰 기준을 본인의 연습 환경에서 확인한 뒤 사용합니다. 이 ZIP을 내려받았다는 사실만으로 실습 완료가 성립하지 않습니다.

# Git·GitHub 02 실습 안내

이 파일은 독자가 상태를 확인하며 따라갈 Markdown 문서입니다. 자동 실행 스크립트나 검수 과정에서 실행한 Git 이력 로그가 아닙니다.

## 목적별 commit을 만드는 실습

1편 이후 README.md에 서로 떨어진 두 문단을 수정합니다. 하나는 실행 방법, 다른 하나는 오타 수정으로 구분합니다. 이미 공유한 commit을 재작성하지 않도록 이 실습에서는 아직 push하지 않은 새 변경만 사용합니다.

```bash
git diff --stat
git diff -- README.md
git add -p README.md
git diff --cached
git diff -- README.md
```

대화형 질문에서 y는 현재 hunk를 staging하고 n은 남깁니다. 한 hunk에 섞였으면 s로 분할할 수 있는지 확인하고, 분할되지 않으면 편집기에서 변경을 다시 나눕니다. cached diff에 첫 목적만 남았을 때 commit하고 나머지 변경을 두 번째 commit으로 만듭니다.

```bash
git commit -m "docs: clarify TaskFlow startup"
git add README.md
git diff --cached
git commit -m "docs: correct wording"
git log --oneline -2
```

이어서 README 한 줄을 다시 수정하고 git add README.md로 stage합니다. 이 추가 변경을 다음 명령으로 index에서만 되돌립니다. 작업 트리의 수정은 남아 있는지 status와 diff로 확인합니다.

```bash
git add README.md
git restore --staged README.md
git status --short
git diff -- README.md
```

마지막 commit의 메시지만 바꾸려면 staged 변경이 없는지 확인한 다음 실행합니다. 방금 unstage한 작업 트리 수정은 이 amend에 포함되지 않고 그대로 남습니다. amend는 새 commit을 만들어 ID를 바꾸며 이미 push한 이력에는 기본 절차로 적용하지 않습니다. --no-edit도 staged 내용까지 기존 commit에 합칠 수 있습니다.

```bash
git diff --cached
git rev-parse HEAD
git commit --amend -m "docs: fix TaskFlow guide wording"
git rev-parse HEAD
git show --stat HEAD
```

.gitignore는 미추적 파일의 추가를 막는 규칙입니다. 이미 추적한 일반 파일을 추적에서 빼는 git rm --cached는 별도의 삭제 commit을 만들므로 대상과 영향을 확인해야 합니다. 비밀이 이미 공개됐다면 ignore 변경만으로 과거 이력이 사라지지 않습니다. 우선 자격증명을 폐기·교체하고 저장소 관리 절차로 대응합니다. 학습 중 실제 비밀을 만들거나 commit하지 않습니다.

공식 근거: https://git-scm.com/docs/git-add · https://git-scm.com/docs/git-restore · https://git-scm.com/docs/git-commit · https://git-scm.com/docs/gitignore

## 체크포인트 기준

git-step-02-clean-commit: 위 실습의 관찰 기준을 본인의 연습 환경에서 확인한 뒤 사용합니다. 이 ZIP을 내려받았다는 사실만으로 실습 완료가 성립하지 않습니다.

# Git·GitHub 03 실습 안내

이 파일은 독자가 상태를 확인하며 따라갈 Markdown 문서입니다. 자동 실행 스크립트나 검수 과정에서 실행한 Git 이력 로그가 아닙니다.

## fast-forward와 merge commit 비교 실습

working tree가 깨끗한지 먼저 확인합니다. 아래 학습용 branch 이름이 이미 있으면 중단하고 기존 작업을 확인합니다. 먼저 feature/a를 만들고 편집기에서 새 문서 docs/branch-a.md에 기능 설명을 작성합니다. docs 폴더가 없으면 편집기로 만듭니다.

```bash
git status --short
git switch -c feature/a
```

파일 작성 후 해당 파일만 commit하고 main으로 돌아와 병합합니다. 이 사이 main에 다른 commit을 만들지 않습니다.

```bash
git add docs/branch-a.md
git commit -m "docs: add branch A notes"
git switch main
git merge --ff-only feature/a
git log --graph --oneline --decorate -5
```

새 merge commit 없이 main이 feature/a의 끝으로 이동하는 것이 fast-forward입니다. 다음에는 같은 main에서 feature/b를 만들고 docs/branch-b.md를 작성해 commit합니다.

```bash
git switch -c feature/b
```

파일 작성 뒤 다음을 실행합니다.

```bash
git add docs/branch-b.md
git commit -m "docs: add branch B notes"
git switch main
```

main에서는 다른 파일 docs/main-notes.md를 작성해 commit합니다. 양쪽에 서로 다른 commit이 생긴 다음 feature/b를 병합합니다.

```bash
git add docs/main-notes.md
git commit -m "docs: add main notes"
git merge feature/b -m "Merge branch feature/b"
git log --graph --oneline --decorate --all -10
git show --no-patch --format='%h %p' HEAD
```

마지막 commit의 부모 ID가 두 개라면 merge commit입니다. --no-ff는 fast-forward가 가능해도 merge commit을 만들도록 선택하는 옵션이며, 이번 두 번째 예제는 이미 갈라진 이력이므로 없어도 merge commit이 생깁니다. 병합을 확인한 branch만 git branch -d로 정리할 수 있지만 삭제는 실습 완료의 필수 조건이 아닙니다.

공식 근거: https://git-scm.com/docs/git-switch · https://git-scm.com/docs/git-merge · https://git-scm.com/docs/git-branch

## 체크포인트 기준

git-step-03-branch-merge: 위 실습의 관찰 기준을 본인의 연습 환경에서 확인한 뒤 사용합니다. 이 ZIP을 내려받았다는 사실만으로 실습 완료가 성립하지 않습니다.

# Git·GitHub 04 실습 안내

이 파일은 독자가 상태를 확인하며 따라갈 Markdown 문서입니다. 자동 실행 스크립트나 검수 과정에서 실행한 Git 이력 로그가 아닙니다.

## 원격 이력을 확인한 뒤 동기화하기

origin은 저장소 주소의 별명이고 origin/main은 마지막 fetch 시점에 관찰한 원격 main입니다. 실시간 서버 상태 자체가 아닙니다. 기존 TaskFlow 저장소에서 먼저 다음을 확인합니다.

```bash
git status -sb
git remote -v
git branch -vv
git fetch origin
git log --graph --oneline --decorate --all -15
git log --left-right --oneline main...origin/main
```

fetch는 원격 정보를 가져오지만 현재 작업 트리를 자동 병합하지 않습니다. 마지막 비교에서 왼쪽은 local에만, 오른쪽은 원격 추적 branch에만 있는 commit입니다. working tree가 깨끗하고 local main에 고유 commit이 없을 때만 다음처럼 fast-forward 동기화를 선택합니다.

```bash
git switch main
git pull --ff-only origin main
git status -sb
```

양쪽 이력이 갈라지면 --ff-only는 실패합니다. 이때 실패를 강제 push로 덮지 않습니다. 3편의 merge 또는 8편의 공유 여부를 고려한 rebase 중 팀 정책에 맞는 절차를 정합니다. branch의 upstream이 없다면 대상이 맞는지 확인한 뒤 git branch --set-upstream-to=origin/main main을 사용할 수 있습니다.

clone을 비교하려면 기존 프로젝트 안이 아닌 별도 상위 폴더에서 진행합니다. taskflow-peer 폴더가 이미 있으면 실행하지 않습니다. 본인 원격의 읽기 권한을 확인하고 실제 clone 주소를 입력합니다.

```bash
read -r -p "본인의 GitHub clone 주소: " TASKFLOW_REMOTE
if [ -n "$TASKFLOW_REMOTE" ] && [ ! -e taskflow-peer ]; then
  git clone "$TASKFLOW_REMOTE" taskflow-peer
else
  printf '%s\n' '주소와 새 대상 폴더를 확인하세요.'
fi
```

두 clone의 branch와 remote-tracking 상태를 비교합니다. push rejected를 재현하려면 본인의 연습용 원격에 한쪽 clone에서 변경을 먼저 push한 뒤 다른 clone에서 이전 상태를 기준으로 push하는 순서를 사용합니다. 이는 원격을 변경하는 선택 실습입니다. 검수 과정에서는 원격을 만들거나 push하지 않았습니다.

공식 근거: https://git-scm.com/docs/git-fetch · https://git-scm.com/docs/git-pull · https://git-scm.com/docs/git-clone · https://git-scm.com/docs/git-push

## 체크포인트 기준

git-step-04-remote-sync: 위 실습의 관찰 기준을 본인의 연습 환경에서 확인한 뒤 사용합니다. 이 ZIP을 내려받았다는 사실만으로 실습 완료가 성립하지 않습니다.

# Git·GitHub 05 실습 안내

이 파일은 독자가 상태를 확인하며 따라갈 Markdown 문서입니다. 자동 실행 스크립트나 검수 과정에서 실행한 Git 이력 로그가 아닙니다.

## 같은 줄의 충돌을 재현하고 해결하기

독자의 연습용 저장소에서만 진행합니다. clean main의 README.md에 같은 기준 문장이 commit되어 있어야 합니다. feature/conflict-demo 이름이 이미 있으면 기존 작업을 확인한 뒤 새 이름을 선택합니다.

```bash
git switch main
git status --short
git switch -c feature/conflict-demo
```

편집기에서 README의 한 문장을 기능 설명으로 바꾸고 commit합니다. main으로 돌아와 같은 원래 문장을 다른 설명으로 수정하고 별도 commit합니다. 두 문장을 서로 다른 줄에 추가하면 충돌이 발생하지 않을 수 있으므로 같은 줄을 바꿉니다.

```bash
git add README.md
git commit -m "docs: explain feature behavior"
git switch main
```

main 쪽의 같은 줄 수정 후 다음을 실행합니다.

```bash
git add README.md
git commit -m "docs: clarify main behavior"
git switch feature/conflict-demo
git merge main
git status
git diff --name-only --diff-filter=U
git diff -- README.md
```

충돌이 있다면 README에서 <<<<<<<, =======, >>>>>>>가 구분하는 두 의도를 읽습니다. 최종 요구에 맞는 한 문장 또는 두 설명으로 편집하고 marker를 제거합니다. 문서를 확인한 다음 해당 파일만 stage하고 병합 commit을 만듭니다.

```bash
git add README.md
git diff --cached
git commit -m "docs: resolve explanation conflict"
git status --short
```

해결 방향이 불명확하면 진행 중인 merge에서만 git merge --abort를 선택합니다. 이미 병합을 완료한 뒤 abort하는 명령이 아닙니다. merge 시작 전 미완료 변경이 있으면 abort가 원래 상태를 완전히 복원하지 못할 수 있으므로 clean 상태로 시작합니다.

본인 원격과 공개할 변경을 검토한 뒤 feature/conflict-demo를 push하고 GitHub에서 base main, compare feature/conflict-demo인 PR을 만듭니다. Files changed에서 marker가 남지 않았는지 확인하고 프로젝트의 lint/build를 실행합니다. 자신의 PR은 스스로 승인하는 리뷰를 남길 수 없으므로 혼자 학습하면 self-review 결과만 기록하고, 실제 승인 검증은 다른 권한 있는 리뷰어가 있을 때 수행합니다. 병합 후 local main은 fetch/pull로 별도 갱신합니다.

공식 근거: https://git-scm.com/docs/git-merge · https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line

## 체크포인트 기준

git-step-05-conflict-pr: 위 실습의 관찰 기준을 본인의 연습 환경에서 확인한 뒤 사용합니다. 이 ZIP을 내려받았다는 사실만으로 실습 완료가 성립하지 않습니다.

# Git·GitHub 06 실습 안내

이 파일은 독자가 상태를 확인하며 따라갈 Markdown 문서입니다. 자동 실행 스크립트나 검수 과정에서 실행한 Git 이력 로그가 아닙니다.

## 복구 대상별로 명령을 선택하기

이 절은 모든 명령을 연속 실행하는 절차가 아닙니다. 현재 작업을 보존한 연습용 복제본에서 한 상황씩 비교합니다. 파일 내용, staging, branch 위치, 공유 이력은 서로 다른 복구 대상입니다.

| 대상 | 선택 | 남는 상태 |
| --- | --- | --- |
| staging만 해제 | git restore --staged README.md | 작업 트리 수정 유지 |
| 추적 파일의 미commit 수정 취소 | git restore README.md | 기본적으로 index 내용으로 복원, 수정 유실 가능 |
| branch만 이전 commit으로 | git reset --soft HEAD~1 | index·작업 트리 유지 |
| branch와 index를 이전 commit으로 | git reset --mixed HEAD~1 | 작업 트리 유지, staging 해제 |
| branch·index·작업 트리를 이전 commit으로 | git reset --hard HEAD~1 | 추적 파일 수정 유실 가능 |
| 공유 commit의 효과 취소 | git revert | 취소 변경을 새 commit으로 추가 |

soft/mixed/hard 비교는 각각 같은 세-commit 시작 상태의 별도 복제본에서 수행해야 합니다. 순서대로 실행하면 매번 HEAD가 달라져 비교가 성립하지 않습니다. --hard와 clean은 실제 작업을 잃을 수 있으므로 이 자료의 필수 실행 절차에 넣지 않습니다.

공유 commit을 취소하는 예제는 단일 부모의 일반 commit 하나를 대상으로 합니다. 먼저 log에서 대상 ID를 직접 확인한 뒤 입력합니다.

```bash
git status --short
git log --oneline -8
read -r -p "취소할 일반 commit ID: " REVERT_COMMIT
if [ -n "$REVERT_COMMIT" ]; then
  git show --stat "$REVERT_COMMIT"
fi
```

출력에서 대상·내용을 확인하고 clean 상태일 때만 아래를 선택합니다. merge commit은 mainline 선택이 필요한 별도 경우라 이 예제에 넣지 않습니다.

```bash
if [ -n "$REVERT_COMMIT" ]; then
  git revert "$REVERT_COMMIT"
fi
git log --oneline -3
git status --short
```

충돌이 나면 파일을 해결·stage한 후 git revert --continue를 사용하거나 중단하려면 git revert --abort를 선택합니다. 둘을 연속 실행하지 않습니다. 보호된 main은 revert 변경도 별도 branch와 PR로 검토합니다.

잃어버린 commit은 reflog에서 찾고 show로 내용을 확인한 다음 새 구조용 branch에 이름을 붙여 보존할 수 있습니다. reflog는 로컬 기록이며 영구 백업이 아닙니다.

```bash
git reflog --date=local -15
read -r -p "보존할 commit ID: " RECOVERY_COMMIT
if [ -n "$RECOVERY_COMMIT" ]; then
  git show --stat "$RECOVERY_COMMIT"
fi
```

확인한 ID가 맞을 때만 git branch rescue/recovered "$RECOVERY_COMMIT"로 새 이름을 붙입니다. 같은 branch가 있으면 덮어쓰지 않습니다. status/log로 결과를 다시 확인합니다.

공식 근거: https://git-scm.com/docs/git-restore · https://git-scm.com/docs/git-reset · https://git-scm.com/docs/git-revert · https://git-scm.com/docs/git-reflog

## 체크포인트 기준

git-step-06-recovery: 위 실습의 관찰 기준을 본인의 연습 환경에서 확인한 뒤 사용합니다. 이 ZIP을 내려받았다는 사실만으로 실습 완료가 성립하지 않습니다.

# Git·GitHub 07 실습 안내

이 파일은 독자가 상태를 확인하며 따라갈 Markdown 문서입니다. 자동 실행 스크립트나 검수 과정에서 실행한 Git 이력 로그가 아닙니다.

## 임시 변경과 commit을 따로 다루는 실습

clean main에서 feature/context-demo를 만들고 README.md를 아직 commit하지 않은 상태로 수정합니다. 새 branch 이름이 이미 있으면 먼저 기존 작업을 확인합니다.

```bash
git switch -c feature/context-demo
```

README 수정 후 상태를 확인하고 stash합니다. 기본 stash는 추적 파일의 변경을 대상으로 하며 새 파일도 포함하려면 의도한 파일인지 먼저 확인한 후 -u를 선택합니다. 실제 비밀 파일을 stash에 넣지 않습니다.

```bash
git status --short
git stash push -m "TaskFlow context exercise"
git stash list
git stash show -p 'stash@{0}'
git switch main
git switch -c hotfix/context-demo
```

편집기로 docs/hotfix-note.md를 작성하고 작은 hotfix commit을 만듭니다. 그 ID를 show/log로 확인한 뒤 feature branch로 돌아옵니다.

```bash
git add docs/hotfix-note.md
git commit -m "docs: record hotfix note"
HOTFIX_COMMIT=$(git rev-parse HEAD)
git show --stat "$HOTFIX_COMMIT"
git switch feature/context-demo
git cherry-pick "$HOTFIX_COMMIT"
```

cherry-pick은 원래 commit을 없애거나 이동하지 않고 해당 변경을 현재 branch에 적용해 commit을 만듭니다. 상태에 따라 ID가 달라질 수 있습니다. 충돌이 생기면 해결 후 stage하고 git cherry-pick --continue, 중단하려면 --abort를 선택합니다.

먼저 cherry-pick을 끝내고 clean 상태를 확인한 다음 보관한 README 변경을 복원합니다.

```bash
git status --short
git stash list
git stash apply 'stash@{0}'
git diff -- README.md
```

apply는 보관 항목을 남깁니다. pop은 성공적으로 적용하면 항목을 제거하지만 충돌하면 남을 수 있습니다. 따라서 본 실습은 apply로 확인하고 의도한 변경을 commit한 뒤, 정확한 stash 항목을 재확인한 경우에만 drop을 선택합니다. 다른 작업의 stash를 일괄 삭제하지 않습니다.

공식 근거: https://git-scm.com/docs/git-stash · https://git-scm.com/docs/git-cherry-pick

## 체크포인트 기준

git-step-07-context-switch: 위 실습의 관찰 기준을 본인의 연습 환경에서 확인한 뒤 사용합니다. 이 ZIP을 내려받았다는 사실만으로 실습 완료가 성립하지 않습니다.

# Git·GitHub 08 실습 안내

이 파일은 독자가 상태를 확인하며 따라갈 Markdown 문서입니다. 자동 실행 스크립트나 검수 과정에서 실행한 Git 이력 로그가 아닙니다.

## 공유하지 않은 branch의 이력 정리

이 실습은 다른 사람이 기반으로 사용하지 않고 아직 push하지 않은 feature branch에서 수행합니다. main에 직접 적용하지 않습니다. clean 상태에서 feature/rebase-demo를 만들고 README의 작은 변경을 세 번 나누어 commit합니다. 각 commit은 파일을 실제로 수정한 뒤 add와 commit을 실행해 만듭니다.

```bash
git switch main
git switch -c feature/rebase-demo
```

세 commit을 만든 다음 log에서 대상 세 개를 확인합니다. 안전한 비교 기준으로 branch를 하나 보존할 수 있습니다. 이름이 이미 있으면 재사용하지 않습니다.

```bash
git status --short
git log --oneline -4
git branch backup/rebase-demo
git rebase -i HEAD~3
```

편집기에서 첫 commit은 pick으로 남기고 두 번째는 squash 또는 fixup으로 첫 commit에 합치며 세 번째는 pick으로 유지하면 세 commit을 두 개로 정리할 수 있습니다. squash는 메시지를 편집하고 fixup은 합쳐지는 commit의 메시지를 버립니다. drop은 변경을 제외하므로 이번 실습에서는 선택하지 않습니다. 저장·종료 뒤 diff와 log로 최종 파일 내용이 유지됐는지 확인합니다.

```bash
git log --graph --oneline --decorate -6
git diff backup/rebase-demo HEAD
```

내용 변경 없이 이력만 정리했다면 마지막 diff는 비어 있어야 합니다. 최신 main 위로 재배치할 필요가 있으면 fetch 후 feature branch에서 다음을 선택합니다.

```bash
git fetch origin
git rebase origin/main
```

충돌한 경우에만 파일을 편집하고 해당 파일을 add한 뒤 git rebase --continue를 실행합니다. 작업을 포기하려면 진행 중인 rebase에서 --abort를 선택합니다. 성공 후 --continue와 --abort를 연속 실행하는 절차가 아닙니다. rebase에서 ours/theirs의 의미를 일반 merge와 기계적으로 동일시하지 않습니다.

이미 공유한 branch의 이력 재작성은 별도 합의가 필요합니다. --force-with-lease는 원격의 예상 상태를 검사하지만 무조건 안전한 강제 push가 아닙니다. 백그라운드 fetch 등의 영향과 다른 사용자의 작업을 확인해야 하며, 본 실습은 강제 push 없이 로컬 비교로 완료합니다.

공식 근거: https://git-scm.com/docs/git-rebase · https://git-scm.com/docs/git-push

## 체크포인트 기준

git-step-08-rebase: 위 실습의 관찰 기준을 본인의 연습 환경에서 확인한 뒤 사용합니다. 이 ZIP을 내려받았다는 사실만으로 실습 완료가 성립하지 않습니다.

git-step-08-rebase

다음 학습

09 GitHub Pull Request 리뷰 실무

다음 회차로 넘어가기 전에 working tree가 의도한 상태인지 확인하고, 실습 중 만든 임시 branch·stash·worktree가 있다면 유지할 이유가 있는지 정리합니다.