Perihal Pembina Mesej Git Commit โ Panduan Terperinci
Penjana Conventional Commit membina mesej komit Git berstruktur yang mematuhi spesifikasi Conventional Commits. Ia membimbing pembangun dalam memilih Jenis (Type), Skop (Scope), baris Subjek (Subject), huraian Badan (Body) pilihan, dan isu Pengaki (Footer).
Tandakan perubahan pemutus (breaking changes) dengan mudah menggunakan sintaks tanda seru (`type!: description`), rujuk isu yang ditutup (`Closes #123`), dan hasilkan mesej komit standard yang menyokong alatan berautomatik seperti `semantic-release` dan penjana log perubahan (changelog) automatik.
Ciri dan Keupayaan Utama
- Katalog jenis lengkap: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
- Input skop pilihan dan peringatan panjang subjek / ungkapan imperatif masa nyata
- Togol Breaking Change satu klik yang menggunakan sintaks standard tanda seru (`!`)
- Penjana pengaki pautan isu automatik dengan penyalinan `git commit -m` satu klik
Cara Menggunakan
- 1
Pilih jenis komit (cth. `feat` untuk ciri, `fix` untuk pembaikan pepijat).
- 2
Berikan skop pilihan (cth. `api`, `auth`) dan huraian imperatif yang ringkas.
- 3
Semak rentetan komit yang telah dipasang dan salin arahan `git commit` penuh untuk terminal anda.
Kes Penggunaan Lazim
- โ Membimbing pasukan kejuruteraan ke arah piawaian sejarah komit Git yang konsisten
- โ Mengautomasikan peningkatan versi semantik dan nota pelepasan automatik dengan talian paip CI/CD
- โ Menandakan perubahan pemutus API yang tidak serasi ke belakang semasa kemas kini pustaka utama
Alat Berkaitan
Penjana Tag Meta SEO
Jana tag meta HTML, OpenGraph dan Twitter Card untuk mengoptimumkan keterlihatan enjin carian.
Penjana Fail .gitignore
Cipta templat fail .gitignore yang sesuai mengikut bahasa pengaturcaraan, rangka kerja dan IDE.
Penjana Lesen Sumber Terbuka
Pilih dan jana fail lesen perisian sumber terbuka yang sah (MIT, Apache 2.0, GPL-3.0, BSD).
Penjana Fail README.md
Bina dokumentasi README projek GitHub yang profesional dengan lencana status dan panduan pemasangan.
Kalkulator Versi SemVer
Sahkan dan kira kenaikan versi semantik (Major, Minor, Patch) mengikut spesifikasi SemVer 2.0.
Pelihat Spesifikasi OpenAPI / Swagger
Render dan terokai dokumentasi titik akhir spesifikasi OpenAPI/Swagger interaktif daripada fail JSON/YAML.
Soalan Lazim dan Privasi
Peningkatan versi semantik manakah yang sepadan dengan setiap jenis komit?
Di bawah konvensyen standard Conventional Commits, `fix` mencetuskan peningkatan PATCH, `feat` mencetuskan peningkatan MINOR, dan sebarang komit dengan `BREAKING CHANGE` mencetuskan peningkatan MAJOR.
Patutkah baris subjek diakhiri dengan tanda noktah?
Tidak. Amalan terbaik Conventional Commits mengesyorkan ayat imperatif yang ringkas tanpa noktah di hujungnya (cth. `feat: allow user avatar upload`).