共计 3228 个字符，预计需要花费 9 分钟才能阅读完成。
提醒：本文最后更新于 2024-11-18 03:17，文中所关联的信息可能已发生改变，请知悉！
在使用 Git 进行项目管理时，编写清晰易懂的提交信息对团队协作和后续代码维护都至关重要。一个好的提交信息不仅仅让别人（包括未来的自己）知道你做了什么，更可以帮助生成变更日志，提升代码管理的效率。
这就是语义化提交（Semantic Commit Messages）的意义所在，通过使用预定义的关键字，让每一次提交都自带“身份标签”，更加一目了然。本文将介绍常用的 Git 提交关键字，并给出每个关键字下的不同风格提交示例：一种是更清晰、有描述性的提交信息，另一种则是更加轻松随性的提交信息风格。
1. feat: 新功能的提交
feat 表示该提交是引入了一个新功能。
-
正式风格 ：
git commit -m "feat: add user authentication API"这条信息清楚明了地告诉你，你在这次提交中引入了用户认证的 API。
-
轻松风格 ：
git commit -m "feat: users can now login like pros!"用一种更轻松的方式来传达同样的信息，适合在小团队中创造愉快的氛围。
2. fix: 修复 Bug
fix 用于修复 bug，是我们日常提交中非常常见的一个关键字。
-
正式风格 ：
git commit -m "fix: resolve login failure on Safari"明确指出是修复了 Safari 浏览器上的登录失败问题。
-
轻松风格 ：
git commit -m "fix: Safari can finally let users log in!"用一种调侃的语气描述问题，适合有幽默感的团队！
3. refactor: 重构代码
refactor 代表你重构了代码，但是不涉及新功能或 bug 修复。
-
正式风格 ：
git commit -m "refactor: optimize database query logic"这条信息能让人快速理解你对数据库查询逻辑做了优化，但没有改变功能。
-
轻松风格 ：
git commit -m "refactor: streamlined the data flow, feeling zen"调侃重构让代码逻辑更“平和”，轻松风格的信息也能传递出你对这次改动的自信。
4. chore: 杂项提交
chore 一般用来表示不影响应用功能的杂项工作，比如更新依赖或者修改构建流程。
-
正式风格 ：
git commit -m "chore: update npm dependencies to latest versions"更新依赖是很常见的提交，这样的风格明确且简洁。
-
轻松风格 ：
git commit -m "chore: fresh npm deps, staying up to date!"轻松随性地表达保持依赖最新版本的做法。
5. style: 代码风格修改
style 用于不涉及逻辑变化的提交，比如修正代码格式、空格或分号等。
-
正式风格 ：
git commit -m "style: fix code indentation in main.js"这样能让团队成员知道这次改动只是代码格式的修复，逻辑没有改变。
-
轻松风格 ：
git commit -m "style: beautified code, it's looking sharp!"轻松随性的风格中，用了“beautified”一词让代码格式的修复变得有趣，传递出代码现在更整洁漂亮的感觉。
6. docs: 文档修改
docs 关键字用于更新或修改项目文档，无论是 API 文档、README 文件，还是其他与代码无关的文档内容。
-
正式风格 ：
git commit -m "docs: update API documentation for user login"清晰说明了更新的是与用户登录相关的 API 文档，便于团队查看。
-
轻松风格 ：
git commit -m "docs: added some words... well, for the API!"这条提交信息以一种幽默的方式展示文档的更新，表达出“就是写了一些文字”的轻松感。
7. perf: 性能优化
perf 用于描述性能提升相关的提交，这类提交通常会让系统运行得更快或更高效。
-
正式风格 ：
git commit -m "perf: improve image loading speed"这条提交信息明确表明优化了图片加载的速度，能够让团队了解代码的改进方向。
-
轻松风格 ：
git commit -m "perf: turbocharged image loading, it's super fast now!"这种轻松的风格突出表现出提升的效果，让提交信息充满能量感。
8. test: 添加或修改测试
test 关键字用于标识测试代码的变更，通常用来描述单元测试、集成测试等相关内容。
-
正式风格 ：
git commit -m "test: add unit tests for registration flow"表明为注册流程添加了单元测试，团队可以了解提交的目的和范围。
-
轻松风格 ：
git commit -m "test: more tests, more power! Covered registration."通过“more power”这种轻松的语气来表达添加测试后的自信与安心。
9. ci: 持续集成相关变更
ci 关键字表示与持续集成（Continuous Integration）相关的更改，通常是修改 CI 配置文件、脚本等。
-
正式风格 ：
git commit -m "ci: update GitHub Actions config for test workflow"这条提交信息可以清晰地传达更新了 GitHub Actions 中的测试工作流配置。
-
轻松风格 ：
git commit -m "ci: tweaked CI config, let's hope it works!"用轻松幽默的风格表达对配置是否能正常工作的期待感。
10. build: 构建相关的变更
build 用来描述构建系统的更改，比如更新 webpack 配置、修改 npm scripts 等。
-
正式风格 ：
git commit -m "build: update webpack config for production build"说明这次提交是对生产环境的 webpack 配置进行了修改，便于理解构建系统的变化。
-
轻松风格 ：
git commit -m "build: prepped the build system for launch, fingers crossed!"用“fingers crossed”（手指交叉祈祷好运）轻松地表达出对构建系统调整后的期望。
11. revert: 撤销提交
revert 用于撤销之前的某次提交，通常是因为该提交引发了问题或不再需要。
-
正式风格 ：
git commit -m "revert: revert commit abc1234 due to regression"这是标准的撤销提交风格，清楚指出撤销的具体提交和原因。
-
轻松风格 ：
git commit -m "revert: undo that mistake, let's pretend it never happened"用自嘲的语气表达撤销了之前的错误提交，轻松有趣。
12. deps: 依赖更新
deps 关键字用于描述更新项目依赖的提交，有时也会使用 chore 来代替，具体看项目习惯。
-
正式风格 ：
git commit -m "deps: update axios to v0.21.1"清楚表达你更新了
axios依赖的版本。 -
轻松风格 ：
git commit -m "deps: fresh dependencies! axios is up to date!"用轻松的口吻表达更新了依赖，并表达出保持最新状态的愉快感。
总结
掌握 Git 语义化提交的关键字，不仅可以帮助团队更好地管理项目进展，也可以为你的代码库带来更多的清晰度和规范性。无论是选择正式的风格，还是轻松随性的风格，都可以根据团队的文化氛围自由发挥。
提交的建议
- 正式风格 ：在生产环境或者团队合作项目中，使用清晰、简洁的提交信息尤为重要，便于未来的追溯和查找问题。
- 轻松风格 ：如果你在个人项目中，或者团队氛围较为轻松愉快，也可以采用轻松的风格，这样不仅能增加项目的趣味性，还能拉近团队成员之间的距离。
记住，关键字只是工具，最终目的是让每个提交都能够快速传达其目的和意义，提升项目协作效率。
