Thomas dot Git 상세 정리

Thomas dot Git 상세 정리 · 별도 원문

본문의 관련 교시에서 연결한 선택 심화다. 각 항목 끝의 교시 링크로 발표와 교재에 돌아갈 수 있다.

일차별 배치표 ↗

G01 · Thomas dot Git 자료의 범위

「Git 브랜치 생성 정리」의 4개 대화를 수업용으로 재구성했다.

• 브랜치 생성·삭제, kysong의 로컬·원격과 origin, Branch·Worktree 관계를 정리했다.
• uc-anchor의 codex/*, staging, main과 Vercel Preview·Production을 연결했다.
• 대화에서 예시로 제시한 Worktree 폴더는 실제 폴더 구성으로 단정하지 않는다.
• 기존 2026-08-27 Git 핸드북도 비교하고 현재 공식 문서와 대조했다.

이 내용을 사용하는 교시

• D2-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G02 · Git의 세 영역

파일 저장, 다음 commit 후보, 확정된 이력을 분리한다.

• 작업 폴더: 지금 수정 중인 파일.
• 스테이징 영역: 다음 commit에 포함할 변경.
• 로컬 저장소: commit으로 확정된 스냅샷과 이력.

1. 01Working tree

   파일 저장·수정

2. 02git add

   변경 선택

3. 03Index

   다음 commit 후보

4. 04git commit

   스냅샷 확정

git status -sb
git diff
git add README.md
git diff --staged
git commit -m "docs: explain local startup"

이 내용을 사용하는 교시

• D2-1 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G03 · origin · main · origin/main

이름이 가리키는 위치를 먼저 찾는다.

이 내용을 사용하는 교시

• D2-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G04 · push · fetch · pull

방향과 현재 파일 변경 여부를 함께 설명한다.

git status -sb
git fetch origin
git log --oneline --left-right main...origin/main
# < 로컬 main에만, > origin/main에만 존재
# main Worktree에서 상태 확인 후
git pull --ff-only origin main

이 내용을 사용하는 교시

• D2-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G05 · 관찰 실습: Git 상태 변화

버튼을 눌러 파일 저장부터 fetch까지 달라지는 상태를 비교한다.

• 이 화면은 가상 이력 시뮬레이션이며 실제 Git 저장소를 변경하지 않는다.
• 원격 추가 commit 이후 fetch를 해도 로컬 파일은 그대로 남는다.

2일차 발표에서 Git 상태 변화 버튼 실습 ↗ (온라인 안내)

이 내용을 사용하는 교시

• D2-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G06 · 브랜치 생성과 작은 commit

검증된 기준점에서 한 목적의 변경을 만든다.

• 작업 변경을 보존한 뒤 기준 브랜치와 upstream을 확인한다.
• git add . 대신 관련 파일을 골라 stage한다.
• 한 commit에는 한 목적을 담고 diff와 실행 결과를 남긴다.

git status -sb
git switch main
git pull --ff-only origin main
git switch -c codex/login-copy
# 안내 문구 한 곳 수정 후
git diff
git add README.md
git diff --staged
git commit -m "docs: clarify login setup"
git push -u origin codex/login-copy

이 내용을 사용하는 교시

• D2-1 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G07 · PR은 검토, merge는 이력 반영

commit·push·PR·merge·deploy는 다른 사건이다.

• commit: 로컬 기록. push: 원격에 전달.
• PR: base와 head의 diff·검증·대화를 모은 검토 요청.
• merge: 선택한 방식으로 대상 브랜치에 이력을 반영.
• deploy: 특정 소스를 빌드해 실행 환경에 배치.

이 내용을 사용하는 교시

• D2-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G08 · 세 가지 병합 방식

이력 모양과 SHA가 달라지는 이유를 설명한다.

이 내용을 사용하는 교시

• D2-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G09 · Branch와 Worktree의 관계

브랜치는 이력의 이름, Worktree는 실제 파일을 다루는 폴더다.

1. 01공유 저장소

   commit 객체·브랜치·원격 참조

2. 02Worktree A

   main · 운영 기준

3. 03Worktree B

   codex/login · 로그인 변경

4. 04Worktree C

   codex/export · 내보내기 변경

이 내용을 사용하는 교시

• D2-4 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G10 · Worktree 생성·실행·점검

동시에 열어 둘 작업만 별도 폴더로 만든다.

• 예시 경로이며 실제 프로젝트 경로를 가정하지 않는다.
• 각 폴더의 의존성·.env.local·포트·연결 DB를 따로 확인한다.

git worktree list
git branch -avv
# main에서 새 브랜치와 폴더 생성
git worktree add -b codex/export ../course-export main
cd ../course-export
git status -sb
# lockfile에 맞게 설치 후 개발 서버 실행
# 두 서버를 함께 켜면 서로 다른 포트를 사용

새 수업용 저장소에서 Worktree 목록과 미커밋 변경을 먼저 읽어줘. main 기준 codex/export 브랜치와 별도 폴더를 제안해줘. 생성 후 각 폴더의 브랜치·HEAD·의존성·환경변수 이름·서버 포트를 확인해줘. 비밀값을 복사해 출력하지 말고 실제 코드 수정은 지정한 파일 한 곳으로 제한해줘.

이 내용을 사용하는 교시

• D2-4 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G11 · Worktree를 여러 기기와 함께 쓸 때

한 Mac의 연결 폴더와 다른 Mac의 clone을 구분한다.

• 같은 로컬 저장소의 linked Worktree들은 객체와 참조를 공유한다.
• Mac Studio와 MacBook은 보통 각각 clone하고 GitHub로 commit을 주고받는다.
• 환경변수·node_modules·Docker·DB 연결이 기기 사이에 자동 동기화되지 않는다.
• 같은 파일을 수정한 브랜치는 병합할 때 충돌할 수 있다.

이 내용을 사용하는 교시

• D2-4 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G12 · staging 브랜치와 Preview 환경

staging은 Git 이름, Preview는 배포 환경 유형이다.

이 내용을 사용하는 교시

• D5-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G13 · 기능에서 운영까지의 검증 경로

통합 검증과 운영 반영을 명시적으로 나눈다.

1. 01codex/기능

   로컬 구현·검증

2. 02PR → staging

   diff·검사·통합

3. 03staging Preview

   기능·권한·회귀

4. 04main 반영 PR

   검증 내용과 호환성

5. 05Production

   배포 commit 확인

6. 06실제 시나리오

   로그인·저장·메일

이 내용을 사용하는 교시

• D5-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G14 · uc-anchor PR #720과 #722

2026-11-09 Git 기록과 당시 배포 관찰을 구분한다.

이 내용을 사용하는 교시

• D5-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G15 · READY · CANCELED · SKIPPED · ERROR

배포 상태가 설명하는 범위를 읽는다.

이 내용을 사용하는 교시

• D5-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G16 · 충돌을 만났을 때의 순서

삭제나 강제 동기화보다 현재 변경의 의미를 먼저 확인한다.

• git status로 충돌 파일과 진행 중 작업을 확인한다.
• 충돌의 양쪽 의도와 필요한 변경을 읽는다.
• 파일을 해결한 뒤 stage하고 관련 검증을 다시 실행한다.
• 원래의 merge를 중단할 때만 git merge --abort를 사용한다.

git status
git diff --name-only --diff-filter=U
# 충돌 표시를 읽고 의미에 맞게 수정
git add README.md
git diff --staged
# 프로젝트의 관련 검사 실행 후 병합 완료

이 내용을 사용하는 교시

• D2-2 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G17 · 복구 대상 세 가지

Git revert, 앱 배포 복구, DB 복구는 범위가 다르다.

이 내용을 사용하는 교시

• D2-2 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G18 · 병합 뒤 Worktree와 브랜치 정리

미커밋 변경·PR·원격과 보존 여부를 먼저 확인한다.

• main과 staging은 유지하고 일회성 기능 작업을 정리한다.
• Worktree 폴더를 일반 파일 삭제로 지우지 않고 worktree remove를 사용한다.
• 원격 삭제, 로컬 삭제, 추적 참조 정리는 각각 다른 동작이다.

git worktree list
git -C ../course-export status --short
# PR 병합과 변경 보존을 확인한 뒤
git worktree remove ../course-export
git branch -d codex/export
# 원격에 남았고 삭제할 대상이 맞을 때만
git push origin --delete codex/export
git fetch --prune

이 내용을 사용하는 교시

• D2-4 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)
• D5-4 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G19 · Git 30분 연습과 완료 기준

새 저장소에서 작은 문구 변경 하나를 끝까지 추적한다.

절차와 실습

1. 0~3분: 폴더·branch·remote·status 확인.
2. 3~10분: 새 branch에서 README 한 곳 수정하고 diff 확인.
3. 10~15분: 해당 파일 stage, staged diff, commit.
4. 15~22분: 수업 원격 push와 PR base/head 확인.
5. 22~27분: 별도 Worktree 목록·HEAD·설정 비교.
6. 27~30분: commit·push·PR·merge·배포 차이를 말로 설명.

이번 Git 실습에서 수행한 단계와 수행하지 않은 단계를 표로 정리해줘. 각 단계의 폴더·브랜치·commit·remote·PR·Preview 증거를 연결해줘. 미완료를 성공으로 표현하지 말고, 다음에 확인할 명령 하나씩 제안해줘.

이 내용을 사용하는 교시

• D2-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)

G20 · Git 질문 카드

다섯 질문에 답하면 상태를 설명할 수 있다.

• commit했는데 GitHub에 안 보인다: 원격으로 push했는가?
• push했는데 main에 없다: 어느 원격 브랜치로 보냈고 PR을 병합했는가?
• origin/main이 오래됐다: 마지막 원격 통신과 fetch 결과는?
• Preview는 정상인데 운영은 다르다: commit·환경변수·DB·callback이 같은 의도인가?
• 브랜치를 지워도 되나: PR·미커밋·Worktree·필요 변경의 보존을 확인했는가?

이 내용을 사용하는 교시

• D2-3 교재 (온라인 안내) · 발표로 돌아가기 (온라인 안내)