커밋할 변경의 파일별 줄 수와 추가·삭제 그래프 요약 확인하기
by 그릿 | GROWTH_ESSAY | 2026-11-17
#practical-guides #Git #개발수정한 파일을 git add로 스테이징한 뒤 커밋에 포함될 파일 목록과 줄 수 변동을 한눈에 파악하려면 요약 옵션을 사용합니다. 커밋 직전에 각 영역의 상태를 파악하는 대표 명령은 다음과 같습니다.
git diff --cached
git diff HEAD
git status --short여기에 요약 옵션을 결합한 git diff --cached --stat을 실행하면 파일별 변경 줄 수와 추가·삭제 그래프를 즉시 확인할 수 있습니다.
왜 이렇게 보이나요
Git에서 파일을 수정한 직후 git diff를 실행하면 작업트리와 인덱스 사이의 차이점이 출력됩니다. 이 상태에서 git add를 실행하면 파일의 변경 사항이 인덱스(Staging Area)에 기록됩니다.
기본 git diff 명령은 작업트리와 인덱스를 비교합니다. git add를 마치면 작업트리의 내용과 인덱스의 내용이 완전히 일치하게 되므로 git diff 명령의 출력 결과가 비어 있게 됩니다. 수정 사항이 사라진 상태가 존재할 수 있으며, 실제로는 다음 커밋을 준비하는 인덱스 영역으로 이동한 상태입니다.
인덱스에 담긴 변경 사항을 저장소의 최신 커밋(HEAD)과 비교하려면 git diff --cached를 실행합니다. git diff --cached는 인덱스와 HEAD 사이의 차이를 보여줍니다. 반면 git diff HEAD는 현재 작업트리와 HEAD를 직접 비교합니다. 두 명령은 비교하는 출발점과 도착점이 명확히 구분되어 서로 다른 검증 목적으로 동작합니다.
만약 git add를 실행한 이후 작업트리의 파일을 추가로 다시 수정하면, 작업트리와 인덱스 사이에 새로운 차이가 발생합니다. 이때 git diff를 다시 실행하면 추가로 수정한 내용만 화면에 표시됩니다. 또한 git diff --cached는 이전에 git add로 담아둔 변경 사항만 계속 유지하여 보여줍니다.
어떤 명령으로 확인하나요
커밋을 만들기 전에 변경 상태를 다각도로 확인해야 합니다. git status --short를 실행하면 파일 상태를 두 글자의 짧은 코드로 표현합니다.
예를 들어 git status --short 실행 시 M note.txt와 같이 출력됩니다. 이 출력에서 첫 번째 칸은 인덱스와 HEAD의 상태를 나타냅니다. 첫 번째 칸의 M은 인덱스에 수정 사항이 스테이징되어 커밋 대상에 포함되었음을 의미합니다. 두 번째 칸은 작업트리와 인덱스의 상태를 나타냅니다. 두 번째 칸이 공백이면 인덱스에 등록된 이후 작업트리에서 추가 수정이 발생하지 않았음을 뜻합니다. 만약 git add 후 작업트리를 다시 수정했다면 두 번째 칸에도 M이 표시되어 MM note.txt 형태로 나타납니다.
커밋에 포함될 구체적인 줄 수와 변경 그래프 요약이 필요할 때는 git diff --cached --stat을 실행합니다. 이 명령은 인덱스에 올라간 파일별로 변경된 줄 수와 +(추가), -(삭제) 기호로 구성된 시각적 그래프를 보여줍니다. 실행 결과는 다음과 같은 형태로 요약됩니다.
note.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)이 요약을 통해 전체 변경 파일 개수와 추가된 줄 수, 삭제된 줄 수의 총합을 직관적으로 검증할 수 있습니다.
적용 조건과 다음 확인
git diff --cached의 실행 결과가 비어 있다고 해서 저장소 전체에 수정 사항이 전혀 없다고 단정하는 판단은 주의가 필요합니다. 인덱스에 등록되지 않은 작업트리의 수정 사항이나, 추적 대상에 아직 포함되지 않은 새 파일이 존재할 가능성이 있습니다.
따라서 커밋 전에는 git status --short를 병행하여 작업트리에 스테이징되지 않은 변경(두 번째 칸 표시)이나 추적되지 않는 파일(?? 표시)이 남아 있는지 함께 확인합니다. 작업트리의 수정까지 한 번에 HEAD와 대조할 때는 git diff HEAD를 활용하고, 최종 커밋에 반영할 요약 통계는 git diff --cached --stat으로 최종 점검한 뒤 커밋을 진행합니다.
새 폴더에서 직접 확인하기
새 예제 폴더에서 실행하세요. 기존 프로젝트에서 초기화 명령을 실행하지 않습니다.
mkdir git-diff-example
cd git-diff-example
git init -q
printf 'before\n' > note.txt
git add note.txt
git -c user.name=Example -c user.email=example@example.invalid -c commit.gpgsign=false commit -qm initial
printf 'after\n' > note.txt
git diff
git add note.txt
git diff
git diff --cached
git diff HEAD
git status --short
git diff --cached --stat실제로 확인한 출력
git diff
diff --git a/note.txt b/note.txt
index 90be1f3..294186e 100644
--- a/note.txt
+++ b/note.txt
@@ -1 +1 @@
-before
+after
git diff
(출력 없음)git diff --cached
diff --git a/note.txt b/note.txt
index 90be1f3..294186e 100644
--- a/note.txt
+++ b/note.txt
@@ -1 +1 @@
-before
+after
git diff HEAD
diff --git a/note.txt b/note.txt
index 90be1f3..294186e 100644
--- a/note.txt
+++ b/note.txt
@@ -1 +1 @@
-before
+after
git status --short
M note.txt
git diff --cached --stat
note.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
예제 확인: git version 2.50.1 (Apple Git-155), 2026-11-17
Git 공식 문서에서 명령의 비교 범위를 확인할 수 있어요.