staging area(index라고도 함)는 작업 디렉터리와 repository 사이의 중간 영역으로, 다음 commit에 어떤 변경 사항이 들어갈지 준비하는 곳입니다. 정확히 무엇을 포함할지 선택하여 commit을 정밀하게 구성할 수 있게 합니다.
작업 디렉터리(WORKING DIRECTORY) → 실제 파일(편집하는 곳)
│ git add
▼
STAGING AREA(index) → 다음 commit을 위해 준비된 변경 사항(준비 구역)
│ git commit
▼
REPOSITORY(.git) → commit된 스냅샷(영구 히스토리)
변경 사항의 흐름: 파일을 편집하고(작업 디렉터리), 로 선택한 변경 사항을 stage하며(staging area), 으로 staged된 변경 사항을 commit으로 기록합니다(repository).
git addgit commit# 파일 3개를 편집했지만, 두 개의 논리적 commit으로 나누어 commit하기:
git add file1.js file2.js # 이 두 개만 stage
git commit -m "Add feature X" # 이것만 commit
git add file3.js # 세 번째 파일 stage
git commit -m "Fix unrelated bug" # 별도의 논리적 commit
# → staging area는 관련된 변경 사항을 깔끔하고 집중된 commit으로 GROUP할 수 있게 함
staging area는 각 commit에 들어갈 정확한 변경 사항을 선택할 수 있게 합니다. 따라서 (모든 변경 사항을 한꺼번에 던져 넣는 대신) 깔끔하고 집중되며 논리적인 commit을 만들 수 있고, 작업의 다른 부분을 별도로 commit할 수도 있습니다.
git add <file> # 파일 stage
git add -p # 파일의 특정 부분(hunk)을 대화형으로 stage
git reset <file> # 파일 UNSTAGE(변경 사항은 유지)
git status # staged된 것 vs staged되지 않은 것 확인
git diff # staged되지 않은 변경 사항
git diff --staged # staged된 변경 사항(commit될 내용)
git add -p는 강력합니다. 파일의 특정 부분을 stage할 수 있어 매우 정밀한 commit이 가능합니다.
staging area를 이해하는 것은 중요합니다. 이것이 Git 모델의 독특하고 근본적인 부분이므로, 이를 파악하는 것이 Git을 효과적으로 사용하는 데 필수적이기 때문입니다.
핵심 개념 — Git에는 세 가지 영역(편집하는 작업 디렉터리, 다음 commit을 준비하는 staging area, commit이 저장되는 repository)이 있고 변경 사항이 add와 commit을 통해 이들을 거쳐 흐른다는 점 — 은 Git이 작동하는 방식의 중심이며, staging area를 이해하지 못하면 add/commit 워크플로에 혼란을 겪게 됩니다.
staging area의 목적이 그 가치를 만듭니다. 정확히 어떤 변경 사항을 포함할지 선택하여 정밀하고 집중된 commit을 구성할 수 있게 합니다. 따라서 (모든 변경 사항을 한 덩어리로 묶는 대신) 관련된 변경 사항을 깔끔하고 논리적인 commit으로 그룹화하고, 작업을 여러 개의 별도 commit으로 나누거나 파일의 일부만 commit할 수도 있습니다(특정 부분을 stage하는 git add -p 사용).
이렇게 깔끔하고 집중된 commit 히스토리를 만드는 능력은 유지보수성에 중요합니다. 잘 정리된 commit은 히스토리를 읽기 쉽고, 검토 가능하며, 이해하거나 되돌리기 쉽게 만듭니다.
staging 명령어(add, add -p, unstage를 위한 reset, commit될 내용을 확인하는 diff --staged)를 이해하는 것은 일상의 실무 지식입니다.
staging area는 Git 워크플로의 근본적이고 독특한 부분(편집과 commit 사이의 중간 단계)이며, 이를 이해하면 깔끔하고 논리적인 commit(좋은 Git 관행의 특징)을 구성할 수 있으므로, staging area를 이해하는 것은 필수적이고 자주 적용되는 Git 지식입니다. 이는 Git의 add/commit 모델을 설명하고 사려 깊은 Git 사용을 구별 짓는 집중되고 잘 정리된 commit 히스토리를 가능하게 하는 핵심 개념으로, Git을 사용하는 모든 개발자에게 중요합니다.