Semantic Commit Messages

Semantic Commit Messages

I. Giới thiệu

Bạn đã từng vò đầu bứt tóc vì commit message của mình quá khó hiểu?

Đừng lo lắng, Semantic Commit Messages chính là vị cứu tinh cho bạn! Phương pháp đơn giản này sẽ giúp bạn viết commit message rõ ràng, súc tích, dễ hiểu. Đồng thời, nó giúp các lập trình viên khác hiểu nội dung commit của bạn.

II. Semantic Commit Messages là gì?

Nói một cách đơn giản, Semantic Commit Messages là một format thống nhất để viết commit message.

Cấu trúc một commit message:

<type>(<scope>): <subject>

📌 Trong đó:

  • type (loại): chore, docs, feat, fix, refactor, style, hoặc test.
  • scope (phạm vi): phạm vi ảnh hưởng mã nguồn (tuỳ chọn).
  • subject (tóm tắt): mô tả ngắn gọn về thay đổi hiện tại.

III. Một số type commit phổ biến

Một số type phổ biến khi commit:

  • feat: xây dựng tính năng mới cho người dùng.
  • fix: sửa lỗi cho người dùng.
  • docs: thay đổi tài liệu.
  • style: thay đổi định dạng, thêm các dấu câu còn thiếu.
  • refactor: cải tiến code mà không thay đổi chức năng.
  • test: thêm hoặc refactor test.
  • chore: nhiệm vụ bảo trì (cập nhật file build, v.v.).

Ví dụ:

fix(middleware): ensure Range headers adhere more closely to RFC 2616