🧩 [1편] Git 커밋 메시지 작성 가이드

부제: 깔끔한 Git 히스토리를 만드는 커밋 구조와 태그 정리

 

📘 글 요약

Git을 처음 쓰는 사람부터 포트폴리오용 프로젝트를 운영하는 개발자까지,
“좋은 커밋이란 무엇인가?”를 쉽게 이해할 수 있는 가이드.

커밋 메시지의 구조, prefix(feat/fix/refactor 등), 작성 규칙, 예시를 통해
누구나 깔끔한 Git 로그를 남길 수 있게 도와줍니다.

---

1️⃣ 커밋 메시지는 “작업의 기록”이다

커밋은 단순한 저장이 아니라
👉 “이 시점까지는 안정적으로 동작한다”
는 개발자의 작업 이력입니다.

 

커밋 메시지는 현재의 나 뿐 아니라 미래의 나 또는 팀원들이
“이 커밋이 왜 만들어졌는지”를 바로 이해할 수 있게 작성해야 합니다.

---

2️⃣ 커밋 메시지 기본 구조

<type>: <간단한 요약>

- <상세 변경 내역 1>
- <상세 변경 내역 2>
- <변경 이유 또는 목적 (선택)>

feat: 코드 기반 UI 초기 세팅 및 SceneDelegate 구성

- Main.storyboard 삭제
- SceneDelegate에서 루트 뷰 코드 연결
- 기본 ViewController 구성 및 앱 아이콘 추가

---

3️⃣ 주요 커밋 타입 (Prefix) 정리

타입	의미	예시
feat	새로운 기능 추가	feat: 홈 화면 감정 요약 UI 구현
fix	버그 수정	fix: CoreData 저장 중 중복 삽입 문제 해결
refactor	코드 구조 개선 (동작 변화 없음)	refactor: ViewModel 데이터 구조 정리
style	코드 포맷, 색상, 간격 등 시각적 수정	style: 버튼 폰트 크기 및 색상 변경
chore	설정, 리소스, 빌드 관련	chore: .gitignore 추가 및 앱 아이콘 설정
docs	문서 수정	docs: README 업데이트
test	테스트 코드 추가/수정	test: 감정 저장 기능 단위 테스트 추가
perf	성능 개선	perf: 이미지 캐싱 최적화

---

4️⃣ 커밋 메시지 작성 규칙

규칙	설명
✅ 제목은 50자 이내, 마침표 ❌	Git 로그 가독성을 높이기 위함
✅ 문장은 현재형 사용	“추가함 ❌ → 추가 ✅”
✅ 제목과 본문은 한 줄 띄워 구분	Git log 시각적 분리 효과
✅ 리스트는 하이픈(-)으로 구분	깔끔하고 일관된 포맷 유지

---

5️⃣ 한눈에 보는 예시

feat: 홈 화면 명언 API 연동 및 감정 요약 UI 구성

- 명언 API 데이터 파싱 및 표시
- 감정별 요약 카드 추가
- 주간 감정 그래프 구성

---

커밋은 코드의 이력서다.
한 줄 한 줄이 프로젝트의 성장 기록이 된다.