ตัวสร้างข้อความ Conventional Commit

สร้างข้อความ Git commit ตามมาตรฐาน Conventional Commits (feat, fix, docs, refactor)

0/72

กรอกคำอธิบายเพื่อดูตัวอย่างข้อความ commit

รูปแบบ Conventional Commits

<type>[scope]: <description>

[optional body]

[optional footer(s)]

ตัวอย่างที่พบบ่อย

เกี่ยวกับ ตัวสร้างข้อความ Conventional Commit — คู่มือการใช้งาน

หมวดหมู่: DevOps และมาตรฐาน ประมวลผลบนเบราว์เซอร์ 100%

เครื่องมือสร้างข้อความคอมมิตแบบมาตรฐาน (Conventional Commit Generator) ช่วยสร้างข้อความคอมมิตของ Git ที่มีโครงสร้างถูกต้องตามข้อกำหนด Conventional Commits โดยจะแนะนำนักพัฒนาในการเลือก Type, Scope, บรรทัด Subject, คำอธิบายเพิ่มเติมในส่วน Body และการอ้างอิง Issue ในส่วน Footer

ทำเครื่องหมายการเปลี่ยนแปลงที่มีผลกระทบรุนแรง (breaking changes) ได้ง่ายๆ ด้วยไวยากรณ์เครื่องหมายอัศเจรีย์ (`type!: description`), อ้างอิง Issue ที่ปิดไป (`Closes #123`) และสร้างข้อความคอมมิตที่เป็นมาตรฐาน ซึ่งช่วยสนับสนุนเครื่องมืออัตโนมัติอย่าง `semantic-release` และระบบสร้างบันทึกการเปลี่ยนแปลง (changelog) อัตโนมัติ

#git #commit #conventional #message #changelog

คุณสมบัติและความสามารถหลัก

  • มีแคตตาล็อกประเภทคอมมิตครบถ้วน: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
  • ช่องระบุ scope ทางเลือก พร้อมคำแนะนำแบบเรียลไทม์สำหรับความยาวของ subject และการใช้ประโยคคำสั่ง (imperative phrasing)
  • ปุ่มเปิด/ปิด Breaking Change ในคลิกเดียว พร้อมใส่ไวยากรณ์เครื่องหมายอัศเจรีย์ (`!`) ตามมาตรฐาน
  • สร้างส่วนท้าย (footer) สำหรับเชื่อมโยงกับ issue โดยอัตโนมัติ พร้อมคัดลอกคำสั่ง `git commit -m` ได้ในคลิกเดียว

วิธีใช้งาน

  1. 1

    เลือกประเภทของคอมมิต (เช่น `feat` สำหรับฟีเจอร์ใหม่, `fix` สำหรับการแก้ไขข้อผิดพลาด)

  2. 2

    ระบุขอบเขต (scope) หากต้องการ (เช่น `api`, `auth`) และเขียนคำอธิบายสั้นๆ กระชับในเชิงคำสั่ง

  3. 3

    ตรวจสอบข้อความคอมมิตที่ประกอบขึ้น และคัดลอกคำสั่ง `git commit` ฉบับเต็มเพื่อนำไปใช้ในเทอร์มินัลของคุณ

ตัวอย่างการใช้งานทั่วไป

  • → ฝึกอบรมและสร้างข้อตกลงร่วมกันในทีมวิศวกรเพื่อสร้างประวัติการคอมมิตของ Git ที่มีมาตรฐานสม่ำเสมอ
  • → ปรับเพิ่มเลขเวอร์ชันตามหลัก Semantic Versioning และสร้างบันทึกการเปิดตัวเวอร์ชันใหม่โดยอัตโนมัติร่วมกับไปป์ไลน์ CI/CD
  • → ส่งสัญญาณแจ้งการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันเก่า (breaking changes) ของ API ระหว่างการอัปเดตไลบรารีครั้งใหญ่

เครื่องมือที่เกี่ยวข้อง

คำถามที่พบบ่อยและความเป็นส่วนตัว

ประเภทของคอมมิตแต่ละแบบส่งผลต่อการปรับเพิ่มเลข Semantic Versioning อย่างไร?

ตามข้อตกลงมาตรฐานของ Conventional Commits นั้น `fix` จะปรับเพิ่มเวอร์ชันระดับ PATCH, `feat` จะปรับเพิ่มเวอร์ชันระดับ MINOR และคอมมิตใดๆ ที่มี `BREAKING CHANGE` จะปรับเพิ่มเวอร์ชันระดับ MAJOR

บรรทัด Subject ควรลงท้ายด้วยเครื่องหมายจุด (มหัพภาค) หรือไม่?

ไม่ควร แนวทางปฏิบัติที่ดีที่สุดของ Conventional Commits แนะนำให้เขียนประโยคคำสั่งที่กระชับโดยไม่ต้องใส่เครื่องหมายจุดปิดท้าย (เช่น `feat: allow user avatar upload`)