Soạn thảo Conventional Commits

Trình soạn thảo thông điệp commit chuẩn hóa theo quy ước Conventional Commits (feat, fix, docs, chore).

0/72

Điền mô tả để xem trước commit message

Định dạng Conventional Commits

<type>[scope]: <description>

[optional body]

[optional footer(s)]

Ví dụ thường gặp

Giới thiệu Soạn thảo Conventional Commits — Hướng dẫn chi tiết

Danh mục: DevOps & Tiêu chuẩn 100% xử lý cục bộ trên trình duyệt

Công cụ Soạn thảo Conventional Commits (Conventional Commit Generator) tạo thông điệp commit Git có cấu trúc tuân thủ đặc tả Conventional Commits. Công cụ hướng dẫn các nhà phát triển lựa chọn Loại (Type), Phạm vi (Scope), Dòng tiêu đề (Subject line), Mô tả chi tiết tùy chọn (Body) và Vấn đề liên kết ở chân trang (Footer).

Dễ dàng đánh dấu các thay đổi phá vỡ tương thích bằng cú pháp dấu chấm than (`type!: description`), liên kết đến các issue đã đóng (`Closes #123`), và xuất các thông điệp commit chuẩn hóa phục vụ các công cụ tự động như `semantic-release` hay các trình tạo changelog tự động.

#git #commit #conventional #message #changelog

Tính năng và khả năng nổi bật

  • Danh mục loại commit đầy đủ: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
  • Trường nhập phạm vi tùy chọn cùng cảnh báo độ dài tiêu đề và nhắc nhở sử dụng thể mệnh lệnh theo thời gian thực
  • Nút bật tắt Breaking Change một chạm áp dụng cú pháp dấu chấm than (`!`) tiêu chuẩn
  • Trình tạo footer liên kết issue tự động cùng tính năng sao chép lệnh `git commit -m` bằng một cú nhấp

Cách sử dụng

  1. 1

    Chọn loại commit (ví dụ: `feat` cho tính năng mới, `fix` cho sửa lỗi).

  2. 2

    Nhập scope tùy chọn (ví dụ: `api`, `auth`) và mô tả ngắn gọn theo thể mệnh lệnh.

  3. 3

    Kiểm tra chuỗi commit hoàn chỉnh đã ghép nối và sao chép toàn bộ lệnh `git commit` cho terminal của bạn.

Trường hợp sử dụng phổ biến

  • → Đưa đội ngũ kỹ sư vào quy chuẩn lịch sử Git commit nhất quán và chuyên nghiệp
  • → Tự động hóa việc nâng phiên bản ngữ nghĩa (semantic versioning) và tạo ghi chú phát hành với CI/CD pipeline
  • → Đánh dấu rõ ràng các thay đổi phá vỡ tính tương thích ngược của API trong các đợt cập nhật thư viện lớn

Công cụ liên quan

Câu hỏi thường gặp và quyền riêng tư

Mỗi loại commit tương ứng với mức tăng phiên bản ngữ nghĩa (semantic version bump) nào?

Theo quy ước Conventional Commits chuẩn, `fix` kích hoạt tăng PATCH, `feat` kích hoạt tăng MINOR, và bất kỳ commit nào chứa `BREAKING CHANGE` sẽ kích hoạt tăng MAJOR.

Dòng tiêu đề (subject) có nên kết thúc bằng dấu chấm không?

Không. Các quy chuẩn thực hành tốt nhất của Conventional Commits khuyến nghị dùng một câu mệnh lệnh ngắn gọn không có dấu chấm ở cuối (ví dụ: `feat: allow user avatar upload`).