เนื้อหา (Body) - แนะนำไม่เกิน 72 ตัวอักษร/บรรทัด
เทมเพลต
📝
git commit formatter,
เครื่องมือจัดรูปแบบข้อความ Git Commit
สร้างข้อความ Conventional Commits ได้ง่ายๆ ผ่าน GUI
แทรก Emoji นับตัวอักษร และคัดลอกได้ทันที
📝
Conventional Commits
เลือก feat/fix/chore ได้อย่างรวดเร็วผ่านอินเทอร์เฟซที่ใช้งานง่าย
🎨
รองรับ Gitmoji
เพิ่มอิโมจิเพื่อแยกแยะประเภทคอมมิตได้ง่ายเมื่อดูประวัติ (log)
✅
นับจำนวนตัวอักษร
ควบคุมความยาวของหัวเรื่อง (50) และเนื้อหา (72) ตามมาตรฐาน Git
ประเภทคอมมิต (Type)
✨ ข้อความที่สร้างขึ้น
⚠️ การจำกัดความยาวของหัวเรื่อง (50 ตัวอักษร) และเนื้อหา (72 ตัวอักษร/บรรทัด) เป็นแนวทางปฏิบัติที่ดีที่สุด (Best Practice) ของ Git (เป็นเพียงคำแนะนำ ไม่ใช่ข้อบังคับ)
about,
เกี่ยวกับ
นี่คือเครื่องมืออำนวยความสะดวกที่จะช่วยนักพัฒนาสร้างข้อความ Git commit ที่ปฏิบัติตามมาตรฐาน "Conventional Commits" อย่างเคร่งครัด เพียงแค่คลิกง่ายๆ คุณก็สามารถสร้างข้อความที่มีโครงสร้างเป็นระเบียบได้อย่างรวดเร็ว ประกอบด้วย Type (ประเภท), Scope (ขอบเขต), Subject (หัวเรื่อง), Body (เนื้อหา) และ Footer นอกจากนี้ ยังสามารถนับจำนวนตัวอักษรและแทรก Gitmoji ได้อย่างชาญฉลาดโดยอัตโนมัติ การดำเนินการทั้งหมดประมวลผลบนเบราว์เซอร์ของคุณ
how to,
วิธีใช้งาน
ขั้นตอนที่ 1
เลือกประเภทคอมมิต
เลือกหนึ่งใน 11 ประเภทพื้นฐาน: feat (เพิ่มฟีเจอร์), fix (แก้ไขบั๊ก), docs (เอกสาร), refactor และอื่นๆ
ขั้นตอนที่ 2
กรอกหัวเรื่องและเนื้อหา
เขียนสรุปสั้นๆ ในช่องหัวเรื่อง (Subject) เพิ่มคำอธิบายโดยละเอียดในช่องเนื้อหา (Body)
ขั้นตอนที่ 3
คัดลอกและวาง
คลิกปุ่มคัดลอก (Copy) และวางลงในเทอร์มินัล (git commit -m) หรือหน้าจอซอฟต์แวร์จัดการ Git
glossary,
คำศัพท์
- Conventional Commits
- มาตรฐานการออกแบบข้อความคอมมิตที่มีโครงสร้าง: <type>(<scope>): <description> การนำมาตรฐานนี้มาใช้จะช่วยให้เครื่องมือต่างๆ สร้าง CHANGELOG อัตโนมัติและวิเคราะห์ SemVer ได้ง่ายขึ้น
- Gitmoji
- การใช้อิโมจิ (emoji) ไว้หน้าข้อความคอมมิตเพื่อเน้นวัตถุประสงค์ของการเปลี่ยนแปลงให้เห็นชัดเจน เช่น ✨ = ฟีเจอร์ใหม่, 🐛 = แก้ไขบั๊ก
- Subject (หัวเรื่อง)
- บรรทัดแรกของข้อความคอมมิต แนะนำให้ใช้ความยาวไม่เกิน 50 ตัวอักษร ควรเขียนในรูปประโยคคำสั่งเพื่ออธิบายว่า "คุณทำอะไรไปบ้าง"
- Body (เนื้อหา)
- บรรทัดอธิบายรายละเอียดของการเปลี่ยนแปลง เว้นบรรทัดว่างจาก Subject 1 บรรทัด แนะนำให้ใช้ความยาวไม่เกิน 72 ตัวอักษรต่อบรรทัดเพื่อให้ log แสดงผลได้อย่างสวยงาม
- Footer (ส่วนท้าย)
- ส่วนที่ใช้บันทึกการอ้างอิงหมายเลข Issue, Pull Request (เช่น Closes #123) หรือการประกาศ BREAKING CHANGE
- Scope (ขอบเขต)
- คำค้นหา (คีย์เวิร์ด) เสริมที่อยู่ในวงเล็บ ซึ่งระบุส่วนที่ได้รับผลกระทบจากคอมมิต เช่น feat(auth) หมายถึงฟีเจอร์ที่อยู่ในโมดูลการยืนยันตัวตน (Authentication)
- BREAKING CHANGE
- การเปลี่ยนแปลงที่ทำให้ไม่สามารถใช้งานร่วมกับโค้ดเวอร์ชันเก่าได้ (Backward Compatibility) สามารถระบุได้ด้วยเครื่องหมายอัศเจรีย์ (!) หลังประเภท (type) หรือเขียนคำนี้ไว้ใน Footer เลย
- SemVer
- การกำหนดเวอร์ชันตามความหมาย (Semantic Versioning) เมื่อใช้งานร่วมกับ Conventional Commits เครื่องมืออย่าง conventional-changelog จะอัปเดตหมายเลขเวอร์ชันอย่างถูกต้องให้โดยอัตโนมัติ
faq,
คำถามที่พบบ่อย
- Q.ข้อมูลที่ฉันกรอกจะถูกส่งไปยังเซิร์ฟเวอร์หรือไม่?
- ไม่ การสร้างข้อความคอมมิตทั้งหมดเกิดขึ้นภายในเบราว์เซอร์ของคุณ โค้ดและเนื้อหาคอมมิตของคุณจะไม่หลุดออกไปสู่ภายนอกอย่างแน่นอน
- Q.ฉันสามารถเพิ่มประเภท (type) ของคอมมิตแบบกำหนดเองได้หรือไม่?
- เครื่องมือนี้รองรับ 11 ประเภทมาตรฐานตาม Conventional Commits หากทีมของคุณใช้ประเภทที่กำหนดเอง คุณสามารถพิมพ์เพิ่มเติมในส่วนของผลลัพธ์ที่สร้างขึ้นได้โดยตรง
- Q.จะใช้งานเครื่องมือนี้ร่วมกับ Git hooks ได้อย่างไร?
- คุณสามารถใช้เครื่องมือนี้ร่วมกับ commitlint (ผ่าน hook commit-msg) เพื่อให้แน่ใจว่าสมาชิกทุกคนในทีมปฏิบัติตามรูปแบบ Conventional Commits
- Q.มีส่วนขยาย VS Code ที่มีฟังก์ชันคล้ายกันหรือไม่?
- มี คุณสามารถใช้ส่วนขยาย Commitizen ได้ อย่างไรก็ตาม ข้อดีของเครื่องมือบนเว็บนี้คือคุณสามารถเข้าถึงได้ทันทีจากทุกที่โดยไม่ต้องติดตั้งให้ยุ่งยาก
- Q.ฉันสามารถเขียนข้อความคอมมิตเป็นภาษาไทยได้หรือไม่?
- ได้ เครื่องมือนี้รองรับการพิมพ์ข้อความในทุกภาษา คุณเพียงแค่ต้องปฏิบัติตามข้อตกลงร่วมกันในทีมของคุณ
use cases,
กรณีการใช้งาน
🔍
ปรับปรุงคุณภาพการรีวิวโค้ด
ประวัติคอมมิตที่สม่ำเสมอและชัดเจนช่วยให้ผู้ตรวจสอบเข้าใจจุดประสงค์ของการแก้ไขไฟล์จำนวนมากได้ทันที
📊
สร้าง CHANGELOG อัตโนมัติได้ง่ายขึ้น
เมื่อสร้างประวัติคอมมิตตามมาตรฐาน คุณสามารถใช้เครื่องมืออัตโนมัติเพื่อเขียนไฟล์ CHANGELOG สำหรับเวอร์ชันใหม่ๆ ได้อย่างสะดวก
👨🏫
รักษาระเบียบมาตรฐานในทีม
สถานที่ที่เหมาะสำหรับสมาชิกใหม่หรือนักพัฒนาฝึกหัดเพื่ออ้างอิงวิธีการเขียนคอมมิตโดยไม่ต้องอ่านเอกสารยาวๆ
🎓
สร้างนิสัยการใช้งาน Git ที่ดี
ทำความคุ้นเคยและเข้าใจโครงสร้างข้อความคอมมิตอย่างลึกซึ้ง ซึ่งจะช่วยให้คุณสามารถเขียนข้อความด้วยตนเองผ่านบรรทัดคำสั่งได้ในภายหลัง
ส่งความคิดเห็น
โปรดแจ้งให้เราทราบความคิดเห็นของคุณเพื่อช่วยปรับปรุงเครื่องมือ
ส่งความคิดเห็นสำเร็จ ขอบคุณสำหรับความร่วมมือ!
เกิดข้อผิดพลาด โปรดลองอีกครั้งในภายหลัง
การส่งความคิดเห็นถูกระงับชั่วคราว
เซิร์ฟเวอร์ไม่ว่างหรือระบบป้องกันสแปมทำงานอยู่ โปรดลองอีกครั้งในภายหลัง