WangLiCha
V2EX  ›  问与答

你们都怎么写 Git 的提交消息?

  •  
  •   WangLiCha · Aug 2, 2019 via Android · 7187 views
    This topic created in 2656 days ago, the information mentioned may be changed or developed.

    公司有打算使用 Git 作为代码管理工具,管理员的想法是每次 commit 的时候提交人能写上详细的提交信息,大概像这样:

    提交类型:bug 修复

    修改内容:修复 XXXXXX 的 bug

    修改结果:当 XXXX 时,不再出现 XXXX 的 bug

    我感觉这个提交信息有些过长了……毕竟 GitHub 上的项目都是一行能写完的,然后我们用的 Gogs 的 web 端上默认只显示第一行,但是管理员认为不写这么详细就不便于做质量追溯,而且如果是想单独提交一份更新日志的话无法监督更新日志的内容。

    总之就是,我感觉自己的使用习惯跟管理员都想法挺多矛盾,不知道你们是怎么进行这方面的管理的?

    50 replies  •  2019-08-03 16:20:50 +08:00
    dovme
    dovme
    Aug 2, 2019
    1
    :bug fixed
    learningman
    learningman
    Aug 2, 2019
    2
    在单独弄个数据库存文本,commit 里放文本的 id ?
    YIsion
    YIsion
    Aug 2, 2019
    3
    :bug: fix . bug .
    hymxm
    hymxm
    Aug 2, 2019
    4
    不是可以设置模板的嘛
    blankme
    blankme
    Aug 2, 2019 via Android
    5
    第一行加个 title,写你想写的简短信息就好了
    要看一行还是看完整的都能满足
    loshine1992
    loshine1992
    Aug 2, 2019
    6
    gitmoji
    tankren
    tankren
    Aug 2, 2019❤️1
    7
    请问 v2er 为什么那么喜欢用 迫于????
    seon
    seon
    Aug 2, 2019 via Android
    8
    公司用 gerrit 评审代码,需要按照模板写,大体如下
    问题描述
    问题编号
    问题原因
    解决方案
    评审人
    WangLiCha
    WangLiCha
    OP
    Aug 2, 2019 via Android
    9
    @blankme 哇,你这个方法好
    ezrealinxh
    ezrealinxh
    Aug 2, 2019
    10
    一般都会有个 template
    pkookp8
    pkookp8
    Aug 2, 2019 via Android
    11
    bug bugid fixed
    feature id commit
    Sainnhepark
    Sainnhepark
    Aug 2, 2019 via Android
    12
    如果遇到这种情况我会开一个分支,分支里的每一个提交信息都尽量简短,但是合并的时候尽量把 bug 描述清楚
    WhoMercy
    WhoMercy
    Aug 2, 2019
    13
    针对总的任务做一下总结,
    有必要的话,再针对修改的文件做一下备注
    whitev2
    whitev2
    Aug 2, 2019
    14
    联动 bug 管理系统,提交的时候自动填充进去
    zpf124
    zpf124
    Aug 2, 2019❤️1
    15
    网络上有很多人都推荐 google 的 Angular 提交格式规范, 不知道其他大公司内部有没有别规范.
    https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits


    大概是这个格式.

    ---------------------------

    fix(components/tables): change table attribute typo

    修改了 xxx 的属性名称拼写错误.
    为了解决兼容在接下来的几个版本会依旧保持久的错误写法可用,但会提示警告.
    预计 3 个月后彻底移除拼写错误的版本.

    [issue 275]( http://xxx/xxx/issues/275)
    pipixia
    pipixia
    Aug 2, 2019 via Android
    16
    bug 号
    Felldeadbird
    Felldeadbird
    Aug 2, 2019
    17
    任务下达类,有等级的,则以系统的 ID,如:#1024 任务标题

    临时性的,则 修复 /新增 /删除 XXX
    deepdark
    deepdark
    Aug 2, 2019 via Android
    19
    我一般是 [ bug ] fix #100, add xxx to xxx
    [ feature ] add xxx views/functions
    shakaraka
    shakaraka
    Aug 2, 2019
    20
    no message
    Yishanshan
    Yishanshan
    Aug 2, 2019
    21
    使用 commit 模版,就是网上推荐的那个
    BCy66drFCvk1Ou87
    BCy66drFCvk1Ou87
    Aug 2, 2019 via Android
    22
    no message
    zqx
    zqx
    Aug 2, 2019 via Android
    23
    只有 pull request 才需要写清楚改动和技术方案的细节。commit 只是用于检索每条提交记录的不同,而且 PR 之前也应该合并子分支历史 commit 为一条 commit。
    dttzmm
    dttzmm
    Aug 2, 2019 via Android
    24
    提 bug 或需求都是要有编号的,便于追溯,所以 comment 消息一般规范为单号+空格+故障简述
    Rocka
    Rocka
    Aug 2, 2019
    25
    Conventional Commits
    https://www.conventionalcommits.org
    还可以根据 commit msg 生成 changelog
    mcfog
    mcfog
    Aug 2, 2019 via Android
    26
    拉分支提交一排 wip,pr 前 squash 成一个按规范写

    不过楼主你的这个 commit message 问题不是太长了,而是在没有 issue tracker。应该是 fix #1234 然后自动解析到 issue tracker 里对应内容的 ticket
    zhw2590582
    zhw2590582
    Aug 2, 2019 via iPhone
    27
    Bugfix,反正只有我一个人看
    zachlhb
    zachlhb
    Aug 2, 2019 via Android
    28
    如果是新功能增加,就写增加了什么,如果修复 bug,就写项目管理平台里的 bug id
    weakish
    weakish
    Aug 2, 2019
    29
    管理员要求的修改结果则单独开一个 issue,写在 issue 里。

    剩下的提交类型和修改内容可以并成一行,类型用 angular 风格的前缀或者 gitmoji,

    然后空一行写 close #123 ( 123 为 issue 编号)

    偶尔有额外事项需要说明的,可以在 close 前面写一段简短的说明。
    Trim21
    Trim21
    Aug 2, 2019 via Android
    30
    add new bug (
    avenger
    avenger
    Aug 2, 2019 via iPhone
    31
    wip 😂
    noqwerty
    noqwerty
    Aug 2, 2019 via Android
    32
    commitizen,大大减少了我敲 commit 的时间
    sepdy
    sepdy
    Aug 2, 2019 via Android
    34
    gitmoji 挺好玩的
    zyzhang
    zyzhang
    Aug 2, 2019
    35
    benson458
    benson458
    Aug 2, 2019 via iPhone
    36
    看到好多人直接 update
    txx
    txx
    Aug 2, 2019
    37
    commitizen +1
    level7in
    level7in
    Aug 2, 2019
    38
    add:xxx
    fix:xxx
    WIP:xxx
    怒发一版!!!
    vibbow
    vibbow
    Aug 2, 2019
    39
    up
    minglanyu
    minglanyu
    Aug 2, 2019 via iPhone
    40
    gcmsg
    windsage
    windsage
    Aug 2, 2019 via Android
    41
    直接有模板的,根据 issue 或者问题单号填
    msg7086
    msg7086
    Aug 2, 2019
    42
    模块,提交类型,简要说明

    详细说明(可选)

    module1: Fix #12345, XYZ is no longer XYZ

    XYZ is fixed as ABC.
    fyibmsd
    fyibmsd
    Aug 3, 2019
    43
    alias push="git add . && git commit -m update && ggpush"
    meow33
    meow33
    Aug 3, 2019
    44
    没错,我就喜欢 update,反正自己一个人看,还在前期开发阶段
    darrenfang
    darrenfang
    Aug 3, 2019
    45
    @tankren #7 去看看交易区
    ZXCDFGTYU
    ZXCDFGTYU
    Aug 3, 2019
    46
    新增了代码或者文件:
    Added:
    1. xxxx

    修改了代码或者文件(包括删除代码,但不包括删除文件):
    Modified:
    1. xxxx

    删除了文件:
    Removed:
    1. xxxx

    修复了某个 Bug:
    Fixed:
    1. xxxx (内容格式:修复了因 xxxx (错误原因)导致的 yyyy (错误表现) bug。#issue:1123 (如果有 issue ))

    每一项都说明清楚了自己干了啥就行。

    这是我个人的习惯。
    LxExExl
    LxExExl
    Aug 3, 2019
    47
    格式不重要 但如果不知所云 要么没人给 review 要么直接打回来重写
    HGladIator
    HGladIator
    Aug 3, 2019
    48
    我定了 git commit message 标准, 但是没人用,我就自暴自弃用 `git commit --allow-empty-message --no-edit `
    我建议是找 GitHub 热门项目看看别人是怎么写的,跟着学就好了
    romisanic
    romisanic
    Aug 3, 2019
    49
    有时候提交的是本次处理完成的事儿
    有时候提交的是本次提交时候的进度
    有时候就是一个 bug fix
    有时候甚至就一个_
    而领导同事们经常只是一个 save
    Antidictator
    Antidictator
    Aug 3, 2019 via iPad
    50
    @tankren 如果没记错的话,是二手节点开始使用的
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1108 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 117ms · UTC 23:05 · PVG 07:05 · LAX 15:05 · JFK 18:05
    ♥ Do have faith in what you're doing.