Cách dùng Tạo Conventional Commit
- Chọn type của thay đổi:
featcho tính năng mới,fixcho sửa lỗi, hoặc docs, refactor, perf, test, build, ci, chore, style, revert. - Thêm scope (không bắt buộc, là phần code bị ảnh hưởng) và mô tả ngắn ở thể mệnh lệnh: “add”, không dùng “added”.
- Giải thích what và why trong body; tick Breaking change và mô tả cách chuyển đổi nếu người dùng phải thay đổi gì đó.
- Thêm footer như
Closes #123, sửa các điểm mà phần kiểm tra báo lỗi, rồi sao chép message hoặc lệnhgit commit.
Định dạng Conventional Commits
<type>[optional scope][!]: <description>
[optional body]
[optional footer(s)]| Type | Dùng cho | Tăng phiên bản |
|---|---|---|
feat | Tính năng mới | Minor (1.4.0 → 1.5.0) |
fix | Sửa lỗi | Patch (1.4.0 → 1.4.1) |
! hoặc BREAKING CHANGE: | Thay đổi mà người dùng phải thích ứng | Major (1.4.0 → 2.0.0) |
| docs, style, refactor, perf, test, build, ci, chore, revert | Mọi trường hợp còn lại | Không (trừ khi là breaking) |
Các công cụ như semantic-release, release-please và standard-version đọc những message này để chọn phiên bản tiếp theo và tự động viết changelog; commitlint thì áp dụng quy tắc này trong CI hoặc git hook. Giữ dòng tiêu đề dưới 72 ký tự, mô tả bắt đầu bằng chữ thường với động từ ở thể mệnh lệnh, và không kết thúc bằng dấu chấm. Tạo changelog với Changelog Generator và các lệnh git khác với Git Command Generator.
Cũng được tìm dưới tên: conventional commits, viết commit message, commit message generator, định dạng git commit message, commitlint, feat fix commit, breaking change commit.
Các công cụ dùng kèm tốt với Tạo Conventional Commit
- Máy tính Semver — Mọi thứ về semantic version ở một chỗ: so sánh hai phiên bản, tính major/minor/patch/prerelease tiếp theo, và xem chính xác những phiên bản nào được phép bởi một range npm như ^1.2.0 hay ~2.3, được giải thích bằng ngôn ngữ đơn giản.
- Bảng lệnh Git — Mọi lệnh Git bạn dùng hằng ngày, và cả những lệnh cần khi có sự cố, được giải thích trong một dòng.
- GitHub Actions Generator — Chọn công nghệ, trigger và các bước, bạn sẽ nhận được file .github/workflows/ci.yml có chú thích — gồm cài đặt, cache, lint, test, build, ma trận phiên bản và tùy chọn deploy lên GitHub Pages, Vercel hoặc container registry.
- Trình tạo LICENSE — Thêm giấy phép mã nguồn mở phù hợp vào dự án chỉ trong vài giây.
Câu hỏi thường gặp
Conventional commit là gì?
Đó là commit message theo định dạng type(scope): description, ví dụ fix(auth): handle expired tokens, để các công cụ đọc và quyết định số phiên bản cũng như tạo changelog.
Làm sao đánh dấu một breaking change?
Thêm ! sau type hoặc scope (feat(api)!: …) và thêm footer BREAKING CHANGE: để giải thích điều gì đã thay đổi. Tick Breaking change ở đây để có cả hai.
Khác nhau giữa chore và refactor là gì?
refactor thay đổi cấu trúc code mà không đổi hành vi; chore dành cho các việc bảo trì không ảnh hưởng đến hành vi của mã nguồn, như cập nhật dependency hoặc cấu hình công cụ.
Làm sao viết commit message nhiều dòng từ command line?
Dùng một -m cho mỗi đoạn: git commit -m "header" -m "body" -m "footer". Lệnh git ở đây sẽ tự làm việc này cho bạn, với dấu ngoặc kép đã được escape.
Tôi có thể cài Tạo Conventional Commit như một ứng dụng web và dùng khi không có mạng không?
Có. Tạo Conventional Commit là một ứng dụng web (PWA) có thể cài đặt — cài trực tiếp từ trình duyệt, không cần tải từ cửa hàng ứng dụng. Trên Chrome hoặc Edge (Windows, macOS, Linux, ChromeOS) hoặc Android, bấm Cài đặt ứng dụng ở đầu trang này; trên iPhone và iPad, dùng Chia sẻ → Thêm vào Màn hình chính; trên Mac, dùng File → Add to Dock trong Safari 17 trở lên. Sau đó ứng dụng mở trong cửa sổ riêng với biểu tượng riêng, và vì chạy hoàn toàn trên trình duyệt nên vẫn hoạt động khi không có mạng. Firefox trên máy tính không thể cài ứng dụng web. Cách cài đặt hoạt động thế nào.