สวัสดีครับ บทความนี้เราจะมาเรียนรู้การเขียน Git commit message อย่างไรให้เข้าใจง่ายกันนะครับ (git commit message convention)

สําหรับ Git commit message convention เราะจะใช้รูปแบบการเขียน Commit เป็นแบบนี้ครับ

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

เรามาดูไปทีละส่วนดังนี้ครับ

<type>

เป็นประเภทสิ่งที่เราแก้ไขครับ ส่วนใหญ่จะแบ่งเป็นดังนี้ครับ

build: เป็นการแก้ไขส่วนที่เกี่ยวข้องกับการ Build (เช่น แก้ไข Docker file, Build script)
chore: เป็นการแก้ไขที่ไม่เห็นจากข้างนอก (เช่น การปรับ .gitignore, .prettierrc file ฯลฯ)
feat: การเพิ่ม Feature
fix: การแก้ไข Bug ต่างๆ
docs: การแก้ไขที่เกี่ยวข้องกับเอกสาร
refactor: คือการ Refactor code
perf: คือการปรับปรุงประสิทธิภาพของ Application
test: เกี่ยวข้องกับการ Test เช่น แก้ไข Test case

<scope>

ส่วนนี้จะเป็นส่วนที่บอกว่าสิ่งที่เราแก้ไขนั้นไปเกี่ยวข้องกับส่วนไหนของโปรแกรมของเรา โดยปกติจะเป็นคำนาม ซึ่งจะมีหรือไม่มีก็ได้ครับ เช่น

เป็นส่วนอธิบายว่า Commit นี้เราแก้ไข หรือทําอะไรไป

เป็นคําอธิบายเพิ่มเติมครับ ตรงนี้จะมีหรือไม่มีก็ได้ครับ

ถ้าเรามีการแก้ไข bug รูปภาพในหน้า Home page จะได้ Commit message ประมาณนี้ครับ

fix(view): correct image in home page

ถ้าเราเพิ่ม Feature ในส่วน controller จะได้ Commit message ประมาณนี้ครับ

feat(controller): add new upload feature

ก็ประมาณนี้ครับสําหรับ Git commit message convention ลองนําไปปรับใช้งานดูนะครับ