Nhà phát triển / Git
Trợ giúp thông điệp Conventional Commit (Trình tạo và công cụ kiểm tra)
Tạo thông điệp commit theo định dạng Conventional Commits 1.0.0: chọn loại, thêm phạm vi và mô tả, đánh dấu thay đổi gây gián đoạn, thêm phần thân và chân trang, rồi xem bản phát hành mà một công cụ như semantic-release sẽ tạo từ thông điệp đó.
Trợ giúp thông điệp Conventional Commit (Trình tạo và công cụ kiểm tra): Công cụ viết dòng đầu tiên theo dạng type(scope): description, đặt ! sau phạm vi nếu có thay đổi gây gián đoạn, rồi thêm phần thân và chân trang sau các dòng trống, bao gồm BREAKING CHANGE: cùng ghi chú di chuyển của bạn. Công cụ cảnh báo nếu dòng đầu tiên dài hơn 72 ký tự, có dấu chấm ở cuối hoặc có chữ cái đầu viết hoa, đồng thời cho biết commit sẽ tạo bản phát hành major, minor hay patch. Chạy 100% cục bộ trong trình duyệt của bạn, không có tệp nào được tải lên máy chủ.
- Danh mục
- Công cụ lập trình viên
- Lượt chạy
- Trong trình duyệt của bạn
- Chi phí
- Miễn phí · không cần đăng ký
- Trạng thái khả dụng
- Sẵn sàng sử dụng
Chạy hoàn toàn trong trình duyệt của bạn
Thông điệp commit
feat(auth): add login with passkeys
35 ký tự trong dòng đầu tiên · bản phát hành: minor (tính năng mới)
Conventional Commits 1.0.0: type(scope): description, một phần nội dung không bắt buộc sau một dòng trống và các footer như BREAKING CHANGE:. Dấu ! sau type đánh dấu một thay đổi gây lỗi tương thích. Các công cụ như semantic-release và release-please đọc những thông điệp này để chọn số phiên bản tiếp theo và ghi changelog.
Ví dụ
feat(auth)!: add login with passkeys, a blank line, a body explaining why, and BREAKING CHANGE: sessions now expire after 24 hours. Vì có !, công cụ phát hành sẽ tạo đây thành một phiên bản major.
Các phiên bản
Conventional Commits tương ứng với semantic versioning: fix là patch, feat là minor và các thay đổi phá vỡ tương thích là major. Hãy tính số phiên bản tiếp theo bằng máy tính semver.
Cách sử dụng
- Chọn loại, chẳng hạn feat hoặc fix, rồi thêm phạm vi tùy chọn.
- Viết mô tả ngắn và đánh dấu thay đổi gây gián đoạn nếu có.
- Thêm phần thân hoặc chân trang nếu cần, sau đó sao chép thông điệp.
Quyền riêng tư và giới hạn
Mọi thứ đều chạy trong trình duyệt của bạn.
Công cụ liên quan
Câu hỏi thường gặp
feat và fix khác nhau như thế nào?
feat thêm một tính năng mà người dùng có thể sử dụng và tạo bản phát hành minor; fix sửa một lỗi và tạo bản phát hành patch.
Khi nào một thay đổi được xem là gây gián đoạn?
Khi người dùng hiện tại phải thay đổi một điều gì đó để tiếp tục sử dụng: một tùy chọn bị xóa, một hàm được đổi tên hoặc giá trị mặc định thay đổi.
Tôi có bắt buộc phải sử dụng Conventional Commits không?
Không, nhưng các công cụ như semantic-release, release-please và commitlint dựa vào quy ước này để tự động hóa số phiên bản và nhật ký thay đổi.
Công cụ miễn phí · trong trình duyệt của bạn lượt chạy · không cần tài khoản