掌握 Git 语义化提交:关键字及其用法

15次阅读
没有评论

共计 3228 个字符,预计需要花费 9 分钟才能阅读完成。

在使用 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 语义化提交的关键字,不仅可以帮助团队更好地管理项目进展,也可以为你的代码库带来更多的清晰度和规范性。无论是选择正式的风格,还是轻松随性的风格,都可以根据团队的文化氛围自由发挥。

提交的建议

  • 正式风格 :在生产环境或者团队合作项目中,使用清晰、简洁的提交信息尤为重要,便于未来的追溯和查找问题。
  • 轻松风格 :如果你在个人项目中,或者团队氛围较为轻松愉快,也可以采用轻松的风格,这样不仅能增加项目的趣味性,还能拉近团队成员之间的距离。

记住,关键字只是工具,最终目的是让每个提交都能够快速传达其目的和意义,提升项目协作效率。

正文完
 0
历史的配角
版权声明:本站原创文章,由 历史的配角 于2024-10-21发表,共计3228字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
评论(没有评论)
验证码

您无法复制此页面的内容

了解 未来日记 的更多信息

立即订阅以继续阅读并访问完整档案。

Continue reading