저장소 만들고 첫 커밋하기
Git의 핵심 기능인 저장소 초기화, 파일 스테이징, 커밋을 실제로 실습합니다.
교무실 업무로 비유하면 이번 글은 새 업무 파일철을 만들고, 제출할 문서를 준비함에 올린 뒤, “이 버전은 여기까지 완료”라고 기록을 남기는 과정입니다. Git에서는 그 기록을 커밋이라고 부릅니다.
이 글에서 할 것
- Git 저장소 초기화하기
- 파일 생성하고 스테이징하기
- 첫 커밋 만들기
- 히스토리 확인하기
준비물
실습 1: 프로젝트 폴더 만들기
폴더 생성
이제 Git 저장소를 만들 준비가 끝났습니다. 아직은 평범한 폴더일 뿐이고, 다음 단계에서 Git이 이 폴더의 변경 기록을 관리하도록 만들겠습니다.
실습 2: Git 저장소 초기화
git init
.git 폴더란?
Git이 버전 정보를 저장하는 숨겨진 폴더입니다. 일반 문서 폴더 안에 “변경 기록 보관함”이 하나 생긴다고 생각하면 됩니다. 이 폴더를 직접 수정하거나 삭제하지 않는 것이 안전합니다.
상태 확인
Untracked files? Git이 아직 추적하지 않는 새 파일입니다. 내 책상 위에는 있지만, 아직 업무 파일철의 공식 목록에는 들어가지 않은 문서라고 보면 됩니다.
실습 4: 스테이징 (Staging)
파일 추가
Changes to be committed = 커밋할 준비가 된 파일들입니다. 결재 전에 “이번 저장본에 포함할 문서”를 준비함에 올려 둔 상태입니다. git add만으로는 아직 기록이 확정되지 않고, 다음 단계의 git commit까지 해야 저장 지점이 남습니다.
실습 5: 커밋 (Commit)
첫 커밋 만들기
커밋이란? 준비된 변경사항을 하나의 저장 지점으로 기록하는 것입니다. 사진을 찍는 것과 비슷하지만, 사진 설명처럼 커밋 메시지도 함께 남습니다. 나중에 git log를 보면 이 메시지들이 업무 일지처럼 쌓입니다.
실습 6: 히스토리 확인
로그 보기
git log는 지금까지 남긴 커밋 기록을 보여 줍니다. git log --oneline은 한 줄 요약본이라 초보자가 흐름을 확인하기 더 편합니다.
실습 7: 두 번째 커밋
새 파일 추가
두 번째 커밋을 만들어 보면 Git 기록이 한 장짜리 사진이 아니라, 시간순으로 쌓이는 앨범이라는 점이 보입니다.
핵심 명령어 정리
| 명령어 |
설명 |
사무/교무실 비유 |
git init |
저장소 초기화 |
새 업무 파일철 만들기 |
git status |
상태 확인 |
책상 위 문서와 준비함 상태 점검 |
git add 파일명 |
스테이징 |
이번 저장본에 넣을 문서를 준비함에 올리기 |
git commit -m "메시지" |
커밋 |
준비된 문서를 기록으로 확정하고 메모 남기기 |
git log |
히스토리 보기 |
업무 일지 전체 보기 |
git log --oneline |
간략 히스토리 |
업무 일지 제목만 빠르게 보기 |
AI 도구에 이렇게 요청해도 됩니다
저장소 만들기와 커밋은 AI가 도와주기 좋지만, 커밋 전에는 반드시 어떤 파일이 기록되는지 확인해야 합니다.
현재 폴더에서 git init을 해도 되는지 확인해줘.
pwd, ls, .git 폴더 존재 여부를 먼저 확인하고, 실행 전 나에게 물어봐.
README.md 첫 커밋을 준비해줘.
git status와 git diff로 포함될 파일을 설명하고, git add는 파일명으로만 실행해줘. git commit은 메시지를 확인받은 뒤 실행해줘.
커밋을 고칠 때는 “이 커밋이 push 전 로컬 커밋인지 먼저 확인하고, 내 허락 없이 git commit --amend를 실행하지 마”라고 덧붙이세요.
실수 대처
"fatal: not a git repository"
원인: Git 저장소가 초기화되지 않았거나, 저장소 폴더 밖에서 명령어를 실행함
해결:
git init
이미 저장소를 만든 적이 있다면 먼저 pwd로 현재 위치가 my-first-git-project 안인지 확인하세요.
커밋 메시지를 잘못 썼어요
해결:
git commit --amend -m "새로운 메시지"
아직 GitHub에 push하지 않은 로컬 커밋에서만 사용하는 것이 안전합니다. 이미 다른 사람과 공유한 커밋은 함부로 고치지 않는 편이 좋습니다.
파일을 add 안 했는데 commit 했어요
해결:
git add 파일명
git commit --amend --no-edit
이 방법도 아직 GitHub에 push하지 않은 로컬 커밋일 때만 사용하세요.
실습 완료 체크리스트
다음 편
👉 Git 시리즈 4편: GitHub 연동 - push, pull, clone
💬 댓글
이 글에 대한 의견을 남겨주세요