Chấp hànhgit commitThời sử dụng emoji vi bổn thứ đề giao đả thượng nhất cá "Tiêu thiêm", sử đắc thử thứ commit đích chủ yếu công tác đắc dĩ đột hiện, dã năng cú sử đắc kỳ tại chỉnh cá đề giao lịch sử trung dịch vu khu phân dữ tra trảo.
git commitThời, đề giao tín tức tuân tuần dĩ hạ cách thức:
:emoji1::emoji2: Bất siêu quá 50 cá tự đích trích yếu, thủ tự mẫu đại tả, sử dụng kỳ sử ngữ khí, cú mạt bất yếu gia cú hào
Đề giao tín tức chủ thể
Dẫn dụng tương quan issue hoặc PR biên hào<#110>Sơ thứ đề giao kỳ lệ:
git commit -m":tada: Initialize Repo"| emoji | emoji đại mã | commit thuyết minh |
|---|---|---|
| 🎉 ( khánh chúc ) | :tada: |
Sơ thứ đề giao |
| 🆕 ( toàn tân ) | :new: |
Dẫn nhập tân công năng |
| 🔖 ( thư thiêm ) | :bookmark: |
Phát hành / bản bổn tiêu thiêm |
| 🐛 (bug) | :bug: |
Tu phục bug |
| 🚑 ( cấp cứu xa ) | :ambulance: |
Trọng yếu bổ đinh |
| 🌐 ( địa cầu ) | :globe_with_meridians: |
Quốc tế hóa dữ bổn địa hóa |
| 💄 ( khẩu hồng ) | :lipstick: |
Canh tân UI hòa dạng thức văn kiện |
| 🎬 ( tràng ký bản ) | :clapper: |
Canh tân diễn kỳ / kỳ lệ |
| 🚨 ( cảnh xa đăng ) | :rotating_light: |
Di trừ linter cảnh cáo |
| 🔧 ( ban thủ ) | :wrench: |
Tu cải phối trí văn kiện |
| ➕ ( gia hào ) | :heavy_plus_sign: |
Tăng gia nhất cá y lại |
| ➖ ( giảm hào ) | :heavy_minus_sign: |
Giảm thiếu nhất cá y lại |
| ⬆️ ( thượng thăng tiễn đầu ) | :arrow_up: |
Thăng cấp y lại |
| ⬇️ ( hạ hàng tiễn đầu ) | :arrow_down: |
Hàng cấp y lại |
| ⚡ ( thiểm điện ) 🐎 ( tái mã ) |
:zap::racehorse: |
Đề thăng tính năng |
| 📈 ( thượng thăng xu thế đồ ) | :chart_with_upwards_trend: |
Thiêm gia phân tích hoặc cân tung đại mã |
| 🚀 ( hỏa tiễn ) | :rocket: |
Bộ thự công năng |
| ✅ ( bạch sắc phục tuyển khuông ) | :white_check_mark: |
Tăng gia trắc thí |
| 📝 ( bị vong lục ) 📖 ( thư ) |
:memo::book: |
Soạn tả văn đương |
| 🔨 ( chuy tử ) | :hammer: |
Trọng đại trọng cấu |
| 🎨 ( điều sắc bản ) | :art: |
Cải tiến đại mã kết cấu / đại mã cách thức |
| 🔥 ( hỏa diễm ) | :fire: |
Di trừ đại mã hoặc văn kiện |
| ✏️ ( duyên bút ) | :pencil2: |
Tu phục typo |
| 🚧 ( thi công ) | :construction: |
Công tác tiến hành trung |
| 🗑️ ( lạp ngập dũng ) | :wastebasket: |
Phế khí hoặc san trừ |
| ♿ ( luân y ) | :wheelchair: |
Khả phóng vấn tính |
| 👷 ( công nhân ) | :construction_worker: |
Thiêm gia CI cấu kiến hệ thống |
| 💚 ( lục tâm ) | :green_heart: |
Tu phục CI cấu kiến vấn đề |
| 🔒 ( tỏa ) | :lock: |
Tu phục an toàn vấn đề |
| 🐳 ( kình ngư ) | :whale: |
Docker tương quan công tác |
| 🍎 ( bình quả ) | :apple: |
Tu phục macOS hạ đích vấn đề |
| 🐧 ( xí nga ) | :penguin: |
Tu phục Linux hạ đích vấn đề |
| 🏁 ( kỳ xí ) | :checkered_flag: |
Tu phục Windows hạ đích vấn đề |
| 🔀 ( giao xoa tiễn đầu ) | :twisted_rightwards_arrows: |
Phân chi hợp tịnh |
- gitmoji
- emoji-cheat-sheet
- styleguide-git-commit-message
- atom git commit messages guide
- An emoji guide for your commit messages
- Trình tự viên đề giao đại mã đích emoji chỉ nam —— nguyên lai biểu tình văn tự bất năng loạn dụng
- Ant Design canh tân nhật chí emoji quy phạm
- A Note About Git Commit Messages
- How to write a Git Commit Message (2014)
- how to write a good git commit message
- 5 Useful Tips For A Better Commit Message
- Udacity Git Commit Message Style Guide
- How to commit a change with both “message” and “description” from the command line?
-
Capitalize the.
<subject> -
Do not end the first line with a period.
-
Total characters of the first lineMUSTbeLessthan orEqualto50characters Long.
-
Use thepresent tense( "Add feature" not "Added feature" ).
-
Use theimperative mood( "Move cursor to..." not "Moves cursor to..." ).
-
Use to identify what type of changes introduced in this commit; Allowed keywords:
<type><type>- An Emoji(see below forlist of Suggested Emojis)
- Or a Text:
- feat: Dụng hộ đích tân công năng ( hoặc something biểu tình phù hào )
- fix: bug fix for the user (or emoji)
- docs: Canh cải văn đương ( hoặc biểu tình phù hào )
- style: Cách thức, khuyết thiếu phân hào đẳng; một hữu sinh sản đại mã canh cải ( hoặc biểu tình phù hào )
- refactor: Trọng cấu sinh sản đại mã, lệ như trọng mệnh danh biến lượng ( hoặc biểu tình phù hào )
- test: Thiêm gia khuyết thiếu đích trắc thí, trọng cấu trắc thí; một hữu sinh sản đại mã canh cải ( hoặc biểu tình phù hào )
- chore: Canh tân thô hoạt đẳng; một hữu sinh sản đại mã canh cải
- Reference issues this commit is related to with the status of that Issue; Ex., or or.
Issue #27``Ref T27``Ref T27, T56``Fixes T8 - Supported issue tracker status keywords:
- Fixes
- Fixed
- Closes
- Closed
- Resolves
- Resolved
- Ref
- Issue
- Issues
| Emoji | Raw Emoji Code | Description |
|---|---|---|
| 🎨 | :art: |
when improving theformat/structure of the code tại cải tiến đại mã đích cách thức / kết cấu thời |
| 📰 | :newspaper: |
when creating anew fileĐương sang kiến nhất cá tân văn kiện thời |
| 📝 | :pencil: |
whenperforming minor changes/fixingthe code or language đương đối đại mã hoặc ngữ ngôn tiến hành tiểu đích tu cải thời |
| 🐎 | :racehorse: |
when improvingperformanceTại đề cao tính năng đích thời hầu |
| 📚 | :books: |
when writingdocsTả tác đích thời hầu |
| 🐛 | :bug: |
when reporting abug,with Comment Tag đương báo cáo nhất cá thác ngộ đích thời hầu, dụng bình luận tiêu thiêm |
| 🚑 | :ambulance: |
when fixing abugTại tu lý nhất cá lậu động đích thời hầu |
| 🐧 | :penguin: |
when fixing something onLinuxTại Linux thượng tu đông tây đích thời hầu |
| 🍎 | :apple: |
when fixing something on **Mac OS ** tại Mac OS thượng tu đông tây đích thời hầu |
| 🏁 | :checkered_flag: |
when fixing something on **Windows ** tại Windows thượng tu đông tây đích thời hầu |
| 🔥 | :fire: |
whenremoving codeor files,maybewith@CHANGEDComment Tag đương san trừ đại mã hoặc văn kiện thời, khả năng sử dụng “@Changed” chú thích tiêu thiêm |
| 🚜 | :tractor: |
whenchange file structure.Usually together with 🎨 đương cải biến văn kiện kết cấu thời |
| 🔨 | :hammer: |
whenrefactoringcode trọng cấu đại mã |
| ☔ | :umbrella: |
when addingtestsĐương gia nhập trắc thí đích thời hầu |
| 🔬 | :microscope: |
when addingcode coverageĐương thiêm gia đại mã phúc cái thời |
| 💚 | :green_heart: |
when fixing theCIbuild tại tu lý ci đích thời hầu |
| 🔒 | :lock: |
when dealing withsecurityTại xử lý an toàn vấn đề đích thời hầu |
| ⬆️ | :arrow_up: |
when upgradingdependenciesĐương thăng cấp y lại quan hệ thời |
| ⬇️ | :arrow_down: |
when downgradingdependenciesĐương hàng đê y lại độ thời |
| ⏩ | :fast_forward: |
whenforward-porting featuresfrom an older version/branch đương tòng cựu bản bổn / phân chi chuyển di đặc tính thời |
| ⏪ | :rewind: |
whenbackporting featuresfrom a newer version/branch đương tòng giác tân đích bản bổn / phân chi hướng hậu di thực đặc tính thời |
| 👕 | :shirt: |
when removinglinter/strict/deprecation warnings đương san trừ linter/ nghiêm cách / khí dụng cảnh cáo thời |
| 💄 | :lipstick: |
when improvingUI/Cosmetic tại cải tiến UI |
| ♿ | :wheelchair: |
when improvingaccessibilityTại cải thiện vô chướng ngại hoàn cảnh đích đồng thời |
| 🌐 | :globe_with_meridians: |
when dealing withglobalization/internationalization/i18n/g11n xử lý toàn cầu hóa / quốc tế hóa /i18n/g11n |
| 🚧 | :construction: |
WIP(Work In Progress) Commits,maybewith@REVIEWComment Tag “WIP” đề giao, “Khả năng” gia thượng “@Review” chú thích tiêu thiêm |
| 💎 | :gem: |
NewReleaseTân bản bổn |
| 🥚 | :egg: |
NewReleasewith Python egg tối tân phát bố đích |
| 🎡 | :ferris_wheel: |
NewReleasewith Python wheel package tân phát bố đích Python xa luân bao |
| 🔖 | :bookmark: |
Version **Tags ** tân tag |
| 🎉 | :tada: |
InitialCommit sơ thứ đề giao |
| 🔈 | :speaker: |
when AddingLoggingĐương thiêm gia nhật chí |
| 🔇 | :mute: |
when ReducingLoggingGiảm thiếu nhật chí ký lục thời |
| ✨ | :sparkles: |
when introducingNewFeatures tại giới thiệu tân công năng đích thời hầu |
| ⚡ | :zap: |
when introducingBackward-InCompatibleFeatures,maybewith@CHANGEDComment Tag đương dẫn nhập hướng hậu bất kiêm dung đích công năng thời, khả dĩ sử dụng “@Changed” bình luận tiêu thiêm |
| 💡 | :bulb: |
NewIdea,with@IDEAComment Tag tân đích sang ý, đái hữu “@ sang ý” bình luận tiêu thiêm |
| ❄️ | :snowflake: |
changingConfiguration,Usually together with 🐧 or 🎀 or 🚀 |
| 🎀 | :ribbon: |
Customer requested applicationCustomization,with@HACKComment Tag khách hộ yếu cầu ứng dụng trình tự định chế, đái hữu “@HACK” bình luận tiêu thiêm |
| 🚀 | :rocket: |
Anything related to Deployments/DevOpsNhậm hà dữ bộ thự /DevOps tương quan đích đông tây |
| 🐘 | :elephant: |
PostgreSQLDatabase specific (Migrations, Scripts, Extensions,...) đặc định vu PostgreSQL sổ cư khố ( thiên di, cước bổn, khoách triển,...) |
| 🐬 | :dolphin: |
MySQLDatabase specific (Migrations, Scripts, Extensions,...) đặc định vu MySQL sổ cư khố ( thiên di, cước bổn, khoách triển,...) |
| 🍃 | :leaves: |
MongoDBDatabase specific (Migrations, Scripts, Extensions,...) đặc định vu MongoDB sổ cư khố ( thiên di, cước bổn, khoách triển,...) |
| 🏦 | :bank: |
Generic Databasespecific (Migrations, Scripts, Extensions,...) đặc định vu Generic Database sổ cư khố ( thiên di, cước bổn, khoách triển,...) |
| 🐳 | :whale: |
DockerConfiguration docker phối trí |
| 🤝 | :handshake: |
whenMerge filesĐương hợp tịnh văn kiện thời |
| 🍒 | :cherries: |
when Commit Arise from one or moreCherry-PickCommit(s) đương đề giao do nhất cá hoặc đa cá sơ tuyển đề giao dẫn khởi thời |
-Đề giao(CLI): Giá thị nhất cá phiêu lượng đích CLI công cụ, khả dĩ bang trợ tiêu chuẩn hóa cơ vu thử văn đương đích đề giao tiêu tức, cảm tạ @jakeasmith.
-gitMoji(Firefox & Chrome khoách triển ): Sử dụng emoji tăng cường đề giao công năng, cảm tạ@louisgrasset
-Đại mã biểu tình phù hào:Mozilla đích đại mã biểu tình phù hào dụng biểu tình phù hào gia mật nhĩ đích tín tức, dĩ hoạch thủ nhạc thú hòa lợi nhuận
-Cơ vu biểu tình phù hào đích đồ biểu:Cơ vu biểu tình phù hào đích sổ cư trục thừa đính duyệt canh tân đồ biểu (WebPush VAPID)
- Use the present tense ( "Add feature" not "Added feature" )
- Use the imperative mood ( "Move cursor to..." not "Moves cursor to..." )
- Limit the first line to 72 characters or less
- Reference issues and pull requests liberally after the first line
- When only changing documentation, include in the commit title
[ci skip] - Consider starting the commit message with an applicable emoji:
- 🎨
:art:when improving the format/structure of the code - 🐎
:racehorse:when improving performance - 🚱
:non-potable_water:when plugging memory leaks - 📝
:memo:when writing docs - 🐧
:penguin:when fixing something on Linux - 🍎
:apple:when fixing something on macOS - 🏁
:checkered_flag:when fixing something on Windows - 🐛
:bug:when fixing a bug - 🔥
:fire:when removing code or files - 💚
:green_heart:when fixing the CI build - ✅
:white_check_mark:when adding tests - 🔒
:lock:when dealing with security - ⬆️
:arrow_up:when upgrading dependencies - ⬇️
:arrow_down:when downgrading dependencies - 👕
:shirt:when removing linter warnings
- 🎨
- 🐞 Bug tu phục
- 💄 dạng thức canh tân /less biến lượng canh tân
- 🆕 tân tăng đặc tính
- 🔥 cực kỳ trị đắc quan chú đích tân tăng đặc tính
- 🇺🇸🇨🇳🇬🇧 quốc tế hóa cải động, chú ý giá lí trực tiếp dụng đối ứng quốc gia / địa khu đích kỳ xí.
- 📖 📝 văn đương hoặc võng trạm cải tiến
- ✅ tân tăng hoặc canh tân trắc thí dụng lệ
- 🛎 canh tân cảnh cáo / đề kỳ tín tức
- ⌨️ ♿ khả phóng vấn tính tăng cường
- 🗑 phế khí hoặc di trừ
- 🛠 trọng cấu hoặc công cụ liên ưu hóa
- ⚡️ tính năng đề thăng
Continue with a longer description a.k.a. message body:
- Add a blank line after the summary line, then write as much as you want. Tại trích yếu hành hậu thiêm gia nhất cá không hành, nhiên hậu tùy tâm sở dục địa tả.
- Use up to 72 characters per line for typical text for word wrap. Đối vu tự động hoán hành đích điển hình văn bổn, mỗi hành tối đa sử dụng 72 cá tự phù.
- Use as many characters as needed for atypical text, such as URLs, terminal output, formatted messages, etc. Đối phi điển hình văn bổn sử dụng tẫn khả năng đa đích tự phù, lệ như URL, chung đoan thâu xuất, cách thức hóa tiêu tức đẳng.
- Include any kind of notes, links, examples, etc. as you want. Bao quát nhậm hà loại hình đích chú thích, liên tiếp, kỳ lệ đẳng. Như nhĩ sở nguyện.
We recommend these summary keywords because they use imperative mood, present tense, active voice, and are verbs:
Ngã môn thôi tiến dĩ hạ trích yếu quan kiện tự, nhân vi tha môn sử dụng mệnh lệnh thức ngữ khí, hiện tại thời thái, chủ động ngữ thái, tịnh thả thị động từ:
- Add:Create a capability e.g. feature, test, dependency. Sang kiến nhất cá công năng, lệ như đặc tính, trắc thí, y lại.
- Drop:Delete a capability e.g. feature, test, dependency. San trừ công năng, lệ như công năng, trắc thí, y lại.
- Fix:Fix an issue e.g. bug, typo, accident, misstatement. Tu phục nhất cá vấn đề, lệ như bug, thâu nhập thác ngộ, sự cố, thác ngộ trần thuật.
- Bump:Increase the version of something e.g. a dependency. Tăng gia mỗ sự vật đích bản bổn, lệ như y lại quan hệ
- Make:Change the build process, or tools, or infrastructure. Cải biến cấu kiến quá trình, hoặc công cụ, hoặc cơ sở thiết thi.
- Start:Begin doing something; e.g. enable a toggle, feature flag, etc. Khai thủy tố nhất ta sự tình; lệ như, khải dụng nhất cá thiết hoán, công năng tiêu chí đẳng.
- Stop:End doing something; e.g. disable a toggle, feature flag, etc. Kết thúc tố mỗ sự, lệ như cấm dụng thiết hoán, công năng tiêu chí đẳng.
- Optimize:A change that MUST be just about performance, e.g. speed up code. Nhất cá cải biến, tất tu chỉ thị tính năng, lệ như gia tốc đại mã.
- Document:A change that MUST be only in the documentation, e.g. help files. Chỉ năng tại văn đương trung tiến hành đích canh cải, lệ như bang trợ văn kiện.
- Refactor:A change that MUST be just a refactoring patch nhất cá cải biến, tất tu chỉ thị nhất cá trọng cấu bổ đinh
- Reformat:A change that MUST be just a formatting path, e.g. change spaces. Nhất cá tất tu chỉ thị cách thức hóa lộ kính đích canh cải, lệ như, canh cải không cách.
- Rearrange:A change that MUST be just an arranging patch, e.g. change layout. Nhất cá tất tu chỉ thị an bài bổ đinh đích canh cải, lệ như canh cải bố cục.
- Redraw:A change that MUST be just a drawing patch, e.g. change a graphic, image, icon, etc. Nhất cá cải biến, tất tu chỉ thị nhất cá hội đồ bổ đinh, lệ như cải biến đồ hình, đồ tượng, đồ tiêu đẳng.
- Reword:A change that MUST be just a wording patch, e.g. change a comment, label, doc, etc. Nhất cá tu cải, tất tu chỉ thị nhất cá thố từ bổ đinh, lệ như cải biến nhất cá bình luận, tiêu thiêm, văn đương đẳng.
- Revise:A change that MUST be just a revising patch e.g. a change, an alteration, a correction, etc. Nhất cá tu cải, tất tu thị nhất cá tu cải bổ đinh, lệ như nhất cá biến hóa, nhất cá tu cải, nhất cá canh chính đẳng.
- Refit/Refresh/Renew/Reload:A change that MUST be just a patch e.g. update test data, API keys, etc. Nhất cá tất tu thị bổ đinh đích canh cải, lệ như canh tân trắc thí sổ cư, API mật thược đẳng.