• 我是怎么写 Git Commit message 的?


    作用

    编写格式化的 commit message 能够大大提高代码的维护效率。

    比如:

    • 可以提供更多的历史信息,方便快速浏览;
    • 可以过滤某些 commit(比如文档改动),便于快速查找信息;
    • 可以直接从 commit 生成 Change log

    用的什么规范?

    <type>(<scope>): <subject>
    // 空一行
    <body>
    // 空一行
    <footer>
    

    其中,Header 是必需的,Body 和 Footer 可以省略。

    type

    type 用于说明 commit 的类别。

    • feature A new feature
    • fix A bug fix
    • docs Documentation only changes
    • style Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
    • refactor A code change that neither fixes a bug nor adds a feature
    • perf A code change that improves performance
    • test Adding missing tests or correcting existing tests
    • build Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
    • ci Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
    • chore Other changes that don't modify src or test files
    • revert Reverts a previous commit

    scope

    scope 用于说明 commit 影响的范围,比如数据层、控制层、视图层、具体模块等等,视项目不同而不同。

    subject

    subject 是 commit 目的的简短描述,不超过50个字符。

    body

    Body 部分是对本次 commit 的详细描述,可以分成多行。

    BREAKING CHANGE,用来描述当前 commit 与上一个版本不兼容的地方。

    Issue,用来描述当前 commit 针对的某个issue。

    参考文章

    Commit message 和 Change log 编写指南

    用的什么辅助工具?

    太教条了,太累... 给大家分享一个我使用的工具。

    JetBrains IDE 插件,在 GoLandPhpStorm 中 都可以在插件市场搜索 Git Commit Message Helper

    插件地址:Git Commit Message Helper

    安装后效果,在 git commit 时:

    咱们看一下效果:

    这时,点击 Commit 或 Commit and Push... 即可。

    赶快去体验吧,有问题欢迎来的星球交流讨论 https://t.zsxq.com/iIUVVnA

    作者:新亮笔记(关注公众号,可申请添加微信好友)
    出处:https://www.cnblogs.com/xinliangcoder
    本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

  • 相关阅读:
    Codeforces Round #425 (Div. 2) Problem A Sasha and Sticks (Codeforces 832A)
    bzoj 2301 Problem b
    bzoj 1101 [POI2007]Zap
    bzoj 2005 能量采集
    bzoj 2527 Meteors
    bzoj 2724 [Violet 6]蒲公英
    回顾树状数组
    bzoj 3237 连通图
    bzoj 2733 永无乡
    Codeforces 817C Really Big Numbers
  • 原文地址:https://www.cnblogs.com/xinliangcoder/p/14966193.html
Copyright © 2020-2023  润新知