4강. add, commit과 좋은 커밋 메시지

?1. 이번 강의에서 해결할 문제

서로 관계없는 변경을 한 커밋에 넣으면 리뷰와 되돌리기가 어려워집니다. 커밋할 파일과 줄을 검토하고 하나의 목적을 담은 기록을 만듭니다.

✓2. 학습 목표

✓이 강의를 마치면

• 작업 폴더와 스테이징 영역을 구분합니다.
• 특정 파일을 스테이징하고 내용을 검토합니다.
• 명령형이고 구체적인 커밋 메시지를 작성합니다.

◇3. 핵심 개념

git add는 파일을 영구 저장하지 않고 다음 커밋에 포함할 스냅샷을 준비합니다. git commit은 스테이징된 내용만 새 이력으로 기록합니다. 메시지는 “무엇을 했나”보다 “이 커밋이 적용되면 무엇이 달라지나”를 짧게 표현합니다.

§4. 단계별 명령어와 예시

파일 경로: C:\dev\git-learning-site\README.md

PowerShell

Set-Location C:\dev\git-learning-site
Add-Content README.md "`nGit과 GitHub를 학습하는 프로젝트입니다."
git status --short
git add README.md
git diff --staged
git commit -m "docs: add project introduction"
git status

→5. 명령어가 동작하는 이유

git add README.md는 해당 경로만 index에 올립니다. git diff --staged는 다음 커밋에 실제로 들어갈 차이를 보여 줍니다. 커밋은 작성자, 시간, 부모 커밋과 스냅샷을 연결한 새 객체를 만듭니다.

!6. 자주 하는 실수와 안전한 해결법

!자주 하는 실수

• 확인 없이 git add . 실행: 비밀 파일까지 포함될 수 있습니다. 먼저 git status --short, 가능하면 파일 경로를 명시합니다.
• “수정”, “작업” 같은 메시지: docs: explain project goal처럼 종류와 결과를 씁니다.
• 잘못 스테이징함: 커밋 전이라면 git restore --staged <경로>로 stage에서만 내립니다. 작업 파일은 유지됩니다.

✎7. 직접 실습

✎직접 실습

1. notes.md를 만들고 README도 한 줄 수정합니다.
2. 두 파일 중 하나만 스테이징해 git diff --staged를 확인합니다.
3. 첫 커밋 뒤 나머지 파일을 별도 목적의 커밋으로 기록합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. git add와 git commit은 각각 어느 영역을 변경하나요?
2. 다음 커밋의 내용을 미리 확인하는 명령은 무엇인가요?
3. 커밋 전 잘못 올린 파일을 작업 내용은 유지한 채 stage에서 내리려면 어떻게 하나요?

■9. 핵심 요약

■핵심 요약

커밋은 작은 목적 하나를 담아야 합니다. 파일을 선택해 add하고 staged diff를 확인한 뒤, 결과가 드러나는 메시지로 commit합니다.