[Git] commit 메시지 작성법 7가지

 

개발을 하다 보면 내가 짠 코드인데도 "이걸 왜 수정했더라?" 하며 당황할 때가 있습니다. 혹은 동료가 올린 'commit' 메시지에 '수정', 'test'라고만 적혀 있어 답답했던 경험, 다들 한 번쯤 있으시죠?

좋은 커밋 메시지는 미래의 나, 그리고 동료를 위한 최소한의 예의이자 협업의 핵심입니다. 오늘은 누구나 바로 따라 할 수 있는 쉬운 커밋 메시지 규칙을 소개합니다.

 

1. 제목에 '말머리'를 달아주세요 (Type)

메시지 맨 앞에 이 커밋이 어떤 성격인지 알려주는 단어를 붙여주세요. 이것만으로도 코드의 의도가 명확해집니다.

• Feat: 새로운 기능을 만들었을 때
• Fix: 버그를 고쳤을 때
• Docs: 문서(README 등)를 수정했을 때
• Style: 코드 로직은 그대로인데 줄 바꿈이나 세미콜론 등을 정리했을 때
• Refactor: 코드를 더 깔끔하게 개선했을 때
• Chore: 빌드 설정이나 라이브러리를 추가했을 때

예: Feat: 로그인 화면에 비밀번호 보기 버튼 추가

 

2. 첫 글자는 대문자로, 마침표는 생략하세요

제목은 짧고 강렬한 '헤드라인'입니다. 문장의 끝에 마침표(.)를 찍지 않는 것이 관례입니다.

 

3. "무엇을" 했는지 명확하게 적으세요

'수정함', '업데이트' 같은 애매한 표현보다는 구체적인 동작을 적는 것이 좋습니다.

• 나쁜 예: Fix: 에러 수정
• 좋은 예: Fix: 결제 페이지에서 뒤로가기 시 앱이 종료되는 현상 수정

 

4. 과거형보다는 '명령문'을 사용해 보세요

영문으로 작성할 때는 Fixed나 Added 대신 Fix, Add 같은 동사 원형을 권장합니다. 마치 Git에게 "이 커밋을 적용하면 ~하게 해라"라고 명령하는 느낌으로 작성하는 것이죠.

 

5. 본문은 제목과 한 줄 띄우고 작성하세요

제목만으로 설명이 부족하다면, 한 줄을 비우고 아래에 자세한 내용을 적어주세요. "왜" 이 작업을 했는지 기록하면 나중에 큰 도움이 됩니다.

 

6. '어떻게' 보다는 '왜'를 설명하세요

코드를 보면 '어떻게' 바꿨는지는 알 수 있지만, '왜' 바꿨는지는 작성자만 압니다. 본문에는 변경 이유나 주의사항을 적어주는 것이 좋습니다.

 

7. 이슈 번호를 연결해 보세요

만약 깃허브(GitHub) 같은 도구를 사용한다면, 제목이나 본문 끝에 이슈 번호(#123)를 적어주세요. 나중에 해당 이슈와 커밋이 자동으로 연결되어 관리가 훨씬 편해집니다.

 

 

---

 

💡 요약하자면 이런 모습입니다!

Feat: 회원가입 시 이메일 중복 체크 기능 추가

- 사용자가 이메일 입력 시 실시간으로 중복 여부 확인
- 가입 버튼 클릭 전 미리 검증하여 사용자 경험 개선
- 관련 이슈: #12

지금까지 커밋 메시지를 대충 적으셨다면, 오늘부터는 이 규칙들을 하나씩 적용해 보세요. 어느샌가 협업의 고수가 되어 있는 자신을 발견하게 될 것입니다!