Git 커밋 메시지는 어떻게 작성해야 할까?

Git 커밋 메시지는 어떻게 작성해야 할까? 한글도 괜찮을까?

Git을 처음 배우다 보면 이런 부분에서 막히는 경우가 많습니다.

git commit -m "???"

여기에서 따옴표 안에는 도대체 무엇을 써야 할까요?

또 한글로 써도 되는지, 영어로 써야 하는지, 정해진 규칙이 있는지도 궁금합니다.

결론부터 말하면 한글로 작성해도 전혀 문제가 없습니다.

중요한 것은 언어가 아니라 나중에 봤을 때 어떤 작업을 했는지 쉽게 알 수 있도록 작성하는 것입니다.

⸻

1. 커밋이란 무엇일까?

Git의 커밋은 쉽게 말하면 게임의 세이브 포인트와 비슷합니다.

프로그램을 만들다가 특정 시점의 상태를 저장해 두는 것입니다.

예를 들어 로그인 기능을 만든 뒤 저장하고 싶다면 다음과 같이 할 수 있습니다.

git add .
git commit -m "로그인 기능 추가"

여기에서

로그인 기능 추가

부분을 **커밋 메시지(Commit Message)**라고 합니다.

즉, 커밋 메시지는

“이번 저장에서는 무엇을 바꿨는가?”

를 적어 두는 메모라고 생각하면 됩니다.

⸻

2. 커밋 메시지는 한글로 써도 될까?

당연히 가능합니다.

다음처럼 작성해도 됩니다.

git commit -m "로그인 오류 수정"

영어로 작성해도 됩니다.

git commit -m "Fix login error"

한글과 영어를 섞어도 문제없습니다.

git commit -m "fix: 로그인 오류 수정"

Git은 커밋 메시지가 한글인지 영어인지 신경 쓰지 않습니다.

따라서 혼자 개발하거나 한국인끼리 협업한다면 한글을 사용하는 것이 오히려 더 이해하기 쉬울 수 있습니다.

반대로 해외 개발자와 협업하거나 공개 오픈소스 프로젝트라면 영어를 사용하는 경우가 많습니다.

⸻

3. 가장 좋지 않은 커밋 메시지

처음 Git을 사용할 때 흔히 이런 식으로 작성합니다.

수정
업데이트
작업
다시 수정
최종
최종2
진짜 최종

당장은 문제가 없어 보입니다.

하지만 며칠이나 몇 달 뒤 Git 기록을 보면 문제가 생깁니다.

수정
수정
업데이트
작업
수정
최종

도대체 무엇을 수정했는지 알 수 없습니다.

Git의 장점은 과거 작업 기록을 확인하고 필요하면 이전 상태로 돌아갈 수 있다는 것인데, 커밋 메시지가 이렇게 되어 있으면 그 장점을 제대로 활용하기 어렵습니다.

⸻

4. 좋은 커밋 메시지는 구체적이다

다음과 같이 작성하는 것이 좋습니다.

로그인 버튼 디자인 수정
회원가입 이메일 인증 기능 추가
퀴즈 결과 화면 오류 수정
모바일 메뉴 크기 조정
사용하지 않는 이미지 파일 삭제

이렇게 작성하면 GitHub의 커밋 기록만 봐도 어떤 작업을 했는지 바로 알 수 있습니다.

핵심은 아주 간단합니다.

이번 커밋에서 무엇을 했는지 한 문장으로 작성한다.

⸻

5. Git 초보자에게 추천하는 방법

처음부터 복잡한 개발자 규칙을 외울 필요는 없습니다.

저는 초보자라면 다음 네 가지 정도만 사용하는 것을 추천합니다.

추가:
수정:
변경:
삭제:

예를 들어 새로운 로그인 기능을 만들었다면

추가: 구글 로그인 기능

버그를 고쳤다면

수정: 모바일 로그인 오류

화면 디자인을 바꿨다면

변경: 메인 화면 버튼 디자인

필요 없는 파일을 없앴다면

삭제: 사용하지 않는 이미지 파일

실제 Git 명령은 다음과 같습니다.

git add .
git commit -m "추가: 구글 로그인 기능"
git push

또는

git add .
git commit -m "수정: 모바일에서 메뉴가 잘리는 오류"
git push

이 정도만 사용해도 상당히 깔끔한 Git 기록을 만들 수 있습니다.

⸻

6. 조금 익숙해지면 Conventional Commits 사용하기

개발자들이 많이 사용하는 커밋 메시지 작성 방식 중 하나가 Conventional Commits입니다.

대표적으로 다음과 같은 단어를 사용합니다.

feat:
fix:
docs:
style:
refactor:
test:
chore:

각각의 의미는 다음과 같습니다.

feat

새로운 기능을 추가했을 때 사용합니다.

feat: 구글 로그인 기능 추가

fix

오류나 버그를 수정했을 때 사용합니다.

fix: 모바일 로그인 오류 수정

docs

README와 같은 문서를 수정했을 때 사용합니다.

docs: 설치 방법 추가

style

화면 디자인이나 스타일을 변경했을 때 사용할 수 있습니다.

style: 메인 버튼 크기 조정

refactor

기능은 그대로 두고 코드 구조를 개선했을 때 사용합니다.

refactor: 로그인 코드 구조 개선

test

테스트 코드를 추가하거나 수정했을 때 사용합니다.

test: 로그인 테스트 추가

chore

설정이나 기타 작업에 많이 사용합니다.

chore: 패키지 버전 업데이트

⸻

7. 영어 명령어 + 한글 설명 방식도 좋다

개인적으로 가장 알아보기 쉬운 방법 중 하나는 다음 방식입니다.

feat: AI 퀴즈 생성 기능 추가
fix: 모바일 타이머 오류 수정
style: 결과 화면 디자인 변경
docs: 설치 방법 추가

앞부분은 개발자들이 사용하는 표준적인 영어 표현을 사용하고, 실제 내용은 한글로 작성하는 것입니다.

GitHub의 커밋 목록을 보면 다음처럼 정리됩니다.

feat: 회원가입 기능 추가
feat: 구글 로그인 추가
fix: 모바일 화면 오류 수정
style: 로그인 버튼 디자인 변경
docs: README 사용 방법 추가

작업 흐름이 상당히 쉽게 보입니다.

⸻

8. 한 번에 너무 많은 내용을 커밋하지 않는 것도 중요하다

커밋 메시지보다 더 중요한 습관이 하나 있습니다.

가능하면 한 커밋에 하나의 작업을 중심으로 저장하는 것입니다.

예를 들어 오늘 다음 작업을 모두 했다고 해보겠습니다.

* 로그인 기능 추가
* 메인 화면 디자인 변경
* 모바일 오류 수정
* README 작성

이 모든 작업을 한 번에

여러 기능 수정

이라고 커밋하는 것보다 나눠서 저장하는 것이 좋습니다.

feat: 로그인 기능 추가
style: 메인 화면 디자인 변경
fix: 모바일 메뉴 오류 수정
docs: README 사용 방법 추가

이렇게 해두면 나중에 문제가 생겼을 때 어느 작업에서 문제가 발생했는지 찾기도 쉽습니다.

⸻

9. AI 코딩을 할수록 커밋은 더 중요하다

요즘은 ChatGPT, Codex, Claude Code, Cursor 같은 AI 도구를 이용해 코딩하는 경우가 많습니다.

AI에게 한 번 수정해 달라고 하면 파일 몇 개가 아니라 수십 개가 한꺼번에 바뀌기도 합니다.

그래서 AI 코딩에서는 작업이 잘 되었을 때 자주 커밋해 두는 것이 좋습니다.

예를 들어 다음과 같은 흐름입니다.

feat: 로그인 기능 완성
fix: 로그인 모바일 오류 수정
feat: 관리자 페이지 추가
style: 관리자 화면 디자인 개선

이렇게 중간중간 저장해 두면 AI가 이후 코드를 잘못 수정하더라도 정상적으로 작동하던 시점으로 돌아가기가 훨씬 쉽습니다.

Git 커밋은 단순한 작업 기록이 아니라 AI 코딩에서 사용할 수 있는 안전한 복구 지점이라고 생각하면 됩니다.

⸻

10. 초보자는 이것만 기억하면 된다

Git 커밋 메시지를 어렵게 생각할 필요는 없습니다.

처음에는 다음 방식만 기억해도 충분합니다.

추가: ○○ 기능
수정: ○○ 오류
변경: ○○ 디자인
삭제: ○○ 파일

Git에 조금 익숙해졌다면 다음처럼 사용하면 됩니다.

feat: ○○ 기능 추가
fix: ○○ 오류 수정
style: ○○ 디자인 변경
docs: ○○ 문서 수정

그리고 가장 중요한 원칙은 세 가지입니다.

첫째, 한글로 작성해도 전혀 문제가 없습니다.

둘째, ‘수정’, ‘업데이트’라고만 쓰지 말고 무엇을 수정했는지 작성합니다.

셋째, 한 커밋에는 가능하면 하나의 작업을 중심으로 저장합니다.

Git의 커밋 메시지는 다른 사람에게 보여주기 위한 어려운 개발 용어가 아닙니다.

가장 쉽게 생각하면

미래의 내가 과거의 작업 내용을 알아볼 수 있도록 남기는 메모

입니다.

그래서 영어를 잘 쓰는 것보다 알아보기 쉽게 작성하는 것이 훨씬 중요합니다.