🧭 협업을 위한 Git 커밋 메시지 작성 가이드

Git 커밋 메시지는 단순한 기록이 아닙니다. 팀원 간의 소통 도구이며, 프로젝트의 변경 이력을 명확하게 전달하는 수단입니다. 명확하고 일관된 커밋 메시지는 협업의 효율을 높이고, 코드의 유지보수를 용이하게 합니다.

✍️ 커밋 메시지의 중요성

변경 이력 추적: 어떤 변경이 언제, 왜 이루어졌는지 파악할 수 있습니다.
협업 효율성 향상: 팀원 간의 이해를 돕고, 코드 리뷰를 원활하게 합니다.
자동화 도구 연계: 린트, 배포, CI/CD 등 자동화 도구와의 연계를 용이하게 합니다.

🧱 커밋 메시지의 기본 구조

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

<body>

<footer>

<type>: 커밋의 종류를 나타냅니다.
<scope>: 변경된 범위(파일, 기능 등)를 명시합니다.
<subject>: 변경 사항을 간단히 요약합니다.
<body>: 변경의 이유와 내용을 상세히 설명합니다.
<footer>: 관련 이슈나 참고 사항을 추가합니다.

🏷️ 커밋 타입(`type`) 예시

타입	설명
`feat`	새로운 기능 추가
`fix`	버그 수정
`docs`	문서 수정
`style`	코드 스타일 변경 (포맷팅 등)
`refactor`	코드 리팩토링 (기능 변경 없음)
`test`	테스트 코드 추가 또는 수정
`chore`	빌드 업무, 패키지 매니저 설정 등

📝 커밋 메시지 작성 규칙

제목과 본문을 빈 줄로 구분합니다.
제목은 50자 이내로 작성합니다.
제목의 첫 글자는 소문자로 작성합니다.
제목 끝에 마침표를 사용하지 않습니다.
제목은 명령문 형태로 작성합니다.
본문은 72자 단위로 줄바꿈합니다.
본문에는 변경 이유와 내용을 상세히 설명합니다.
관련 이슈가 있다면 푸터에 명시합니다.

💡 커밋 메시지 예시

✅ 좋은 예시

feat(login): add user authentication

- Implemented login functionality using JWT.
- Added login form validation.
- Integrated with backend API.

Resolves: #42

❌ 나쁜 예시

update

변경 내용이 명확하지 않으며, 협업 시 혼란을 야기할 수 있습니다.

🛠️ 커밋 메시지 템플릿 설정 (선택 사항)

일관된 커밋 메시지를 작성하기 위해 Git 커밋 템플릿을 설정할 수 있습니다.

템플릿 파일 생성:
```
touch ~/.gitmessage.txt
```

템플릿 내용 작성:

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

<body>

<footer>

Git 설정에 템플릿 적용:

git config --global commit.template ~/.gitmessage.txt

이제 git commit 명령어를 사용할 때, 설정한 템플릿이 기본으로 적용됩니다.

티스토리

[Git] 협업을 위한 Git 커밋 메시지 작성 가이드

[Git] 협업을 위한 Git 커밋 메시지 작성 가이드

🧭 협업을 위한 Git 커밋 메시지 작성 가이드

✍️ 커밋 메시지의 중요성

🧱 커밋 메시지의 기본 구조

🏷️ 커밋 타입(`type`) 예시

📝 커밋 메시지 작성 규칙

💡 커밋 메시지 예시

✅ 좋은 예시

❌ 나쁜 예시

🛠️ 커밋 메시지 템플릿 설정 (선택 사항)

🔗 참고 자료

[Git] 협업을 위한 Git 커밋 메시지 작성 가이드

[Git] 협업을 위한 Git 커밋 메시지 작성 가이드

🧭 협업을 위한 Git 커밋 메시지 작성 가이드

✍️ 커밋 메시지의 중요성

🧱 커밋 메시지의 기본 구조

🏷️ 커밋 타입(type) 예시

📝 커밋 메시지 작성 규칙

💡 커밋 메시지 예시

✅ 좋은 예시

❌ 나쁜 예시

🛠️ 커밋 메시지 템플릿 설정 (선택 사항)

🔗 참고 자료

🏷️ 커밋 타입(`type`) 예시