Dev Tool/Git & Github

Git Commit Message(AngularJS)

UNarD 2026. 3. 10. 10:45

🧱 Git Commit Message 제대로 쓰기

커밋 메시지는 단순한 기록이 아닙니다.

“왜, 무엇을, 어떻게 바꿨는지”를 남기는 개발자의 메모이자 협업의 기본 언어입니다.
특히 팀 프로젝트나 대규모 서비스에서는 일관된 커밋 메시지 컨벤션을 사용하는 것이 중요합니다.

저도 처음에는 "수정", "진짜 최종" 같은 메시지를 남기곤 했어요.
나중에 과거 커밋 로그를 보고 머리를 쥐어뜯은 적이 한두 번이 아닙니다. ☕️😂
하지만 규칙을 한 번 익혀두면 git log를 볼 때 히스토리가 훨씬 읽기 쉬워집니다.

이 글에서는 AngularJS 프로젝트에서 사용된 Git Commit Message Convention을 기반으로 가장 널리 사용되는 커밋 메시지 작성 방법을 정리해 보겠습니다.

🗂 전체 골격

커밋 메시지는 크게 3부분으로 구성됩니다.
각 구역은 빈 줄(blank line) 로 구분합니다.

<type>(<scope>): <subject>

<body>

<footer>

이 형식은 AngularJS Git Commit Message Convention에서 시작되었으며
현재는 Conventional Commits 표준의 기반이 되었습니다.

1️⃣ 제목 줄: `<type>(<scope>): <subject>`

가장 윗줄은 커밋의 한 줄 요약입니다.
git log를 확인할 때 가장 먼저 보이는 부분이기 때문에 변경 내용을 짧고 명확하게 작성하는 것이 좋습니다.

🔸 type (필수)

커밋의 작업 종류를 나타냅니다. 이 값을 통해 커밋의 성격을 빠르게 알 수 있습니다.

타입	의미	Java 개발 예시
feat	새로운 기능 추가	새로운 Service, Controller 추가
fix	버그 수정	NPE 수정, 잘못된 로직 수정
docs	문서 수정	README, 문서 업데이트
style	코드 스타일 변경	들여쓰기, import 정렬
refactor	코드 구조 개선	메서드 분리, 중복 제거
test	테스트 관련	JUnit 테스트 추가
chore	기타 작업	빌드 설정, 라이브러리 업데이트

🔸 scope

어떤 기능이나 모듈을 수정했는지 나타냅니다.
필수는 아니지만 작성하면 변경된 영역을 더 쉽게 파악할 수 있습니다.

예를 들어 auth, order, user 같은 모듈 이름을 사용할 수 있습니다.

🔸 subject (필수)

커밋에서 무엇이 변경되었는지 한 줄로 요약하는 부분입니다.
“무엇을 했다” 보다는 “무엇을 한다” 또는 “무엇을 변경” 형태로 작성합니다.

🎀 예시

- feat(auth): 로그인 기능 추가  
- fix(order): 재고 계산 오류 수정
- refactor(user): extract validation logic
- docs(readme): update installation guide

✅ 작성 규칙

명령문 형태 사용
첫 글자는 소문자
마침표(.) 사용하지 않음
50자 이내 권장

2️⃣ 본문: `<body>` (선택)

제목만으로 설명이 부족할 때 변경 이유나 배경을 설명하는 부분입니다.
특히 왜 이런 변경을 했는지를 작성하면 나중에 히스토리를 이해하는 데 도움이 됩니다.

publish events when the order status changes so other services can react.

- publish OrderCompletedEvent when an order is completed
- publish OrderCanceledEvent when an order is canceled

3️⃣ 푸터: `<footer>` (필요할 때)

☑️ Breaking Change

기존 버전과 호환이 깨지는 변경 사항을 명시합니다.

BREAKING CHANGE: OrderService now requires an EventPublisher dependency.

☑️ 이슈 연결

특정 이슈를 해결하는 커밋일 때 사용합니다.

Closes #102

✅ 한 번에 보는 예시

🔠 영문

feat(order): add order status change event

publish events when the order status changes so other services can react.

- publish OrderCompletedEvent when an order is completed
- publish OrderCanceledEvent when an order is canceled

BREAKING CHANGE: OrderService now requires an EventPublisher dependency.
Closes #102

🇰🇷 한국어

feat(order): 주문 상태 변경 이벤트 발행 기능 추가

주문 상태가 변경될 때 다른 서비스가 이를 감지할 수 있도록
이벤트 발행 기능 추가.

- 주문 완료 시 OrderCompletedEvent 발행
- 주문 취소 시 OrderCanceledEvent 발행

BREAKING CHANGE: OrderService에 EventPublisher 의존성이 추가됨.
Closes #102

🎉 마무리

오픈소스 프로젝트나 글로벌 협업 환경에서는 영어 커밋 메시지를 사용하는 경우가 많습니다.

하지만 팀 프로젝트라면 팀 컨벤션에 맞는 언어를 사용하는 것이 가장 중요해요.

저도 영문 커밋 메시지를 작성할 때 가끔 번역기의 도움을 받기도 합니다 😂
그래도 컨벤션을 지키면 git log를 볼 때 히스토리가 훨씬 깔끔하게 정리됩니다.

📚 참고 자료

'Dev Tool > Git & Github' 카테고리의 다른 글

Husky로 Java 자동 포맷팅 설정하기 (google-java-format) (0)	2026.03.09
Husky로 Java 자동 포맷팅 설정하기 (clang-format) (0)	2026.03.09
GitHub에 첫 push 로그인 에러 해결법 (MacOS) (0)	2025.05.09

현재글Git Commit Message(AngularJS)

UNarD

Git Commit Message(AngularJS)

🧱 Git Commit Message 제대로 쓰기

🗂 전체 골격

1️⃣ 제목 줄: `<type>(<scope>): <subject>`

🔸 type (필수)

🔸 scope

🔸 subject (필수)

🎀 예시

✅ 작성 규칙

2️⃣ 본문: `<body>` (선택)

3️⃣ 푸터: `<footer>` (필요할 때)

☑️ Breaking Change

☑️ 이슈 연결

✅ 한 번에 보는 예시

🔠 영문

🇰🇷 한국어

🎉 마무리

📚 참고 자료

'Dev Tool > Git & Github' 카테고리의 다른 글

'Dev Tool/Git & Github'의 다른글

티스토리툴바

Git Commit Message(AngularJS)

🧱 Git Commit Message 제대로 쓰기

🗂 전체 골격

1️⃣ 제목 줄: <type>(<scope>): <subject>

🔸 type (필수)

🔸 scope

🔸 subject (필수)

🎀 예시

✅ 작성 규칙

2️⃣ 본문: <body> (선택)

3️⃣ 푸터: <footer> (필요할 때)

☑️ Breaking Change

☑️ 이슈 연결

✅ 한 번에 보는 예시

🔠 영문

🇰🇷 한국어

🎉 마무리

📚 참고 자료

'Dev Tool > Git & Github' 카테고리의 다른 글

'Dev Tool/Git & Github'의 다른글

관련글

티스토리툴바

1️⃣ 제목 줄: `<type>(<scope>): <subject>`

2️⃣ 본문: `<body>` (선택)

3️⃣ 푸터: `<footer>` (필요할 때)