美文网首页
git commit 提交规范

git commit 提交规范

作者: KB_MORE | 来源:发表于2022-01-19 20:50 被阅读0次

    后期优化了一版更加清晰, 可以直接参考 git commit 提交规范(优化)

    不规范?

    Git每次提交代码,都要写 Commit message(提交说明),否则就不允许提交。但是,一般来说,commit message 应该清晰明了,说明本次提交的目的。当出现问题或者查看提交记录的时候也能快速的定位到该次提交, 不正当的提交,让人一头雾水,😳再😳

    • 1.测试提交?
    • .中英混合?
    • .no no no 是什么?
    😰.jpg 😒.jpg

    再看下前端框架Angular.js 采用的规范提交记录

    591642591847_.pic_hd.jpg
    会不会清晰很多😀, (好像英文看起来没中文的简洁😂, 当然这只是语言问题, 我们自己开发项目提交记录还是用中文)

    配置

    规范带来的好处就不再多说, 直接上干货, 文章末尾会附上脚本, 可根据自身需求更改模板

    1.下载脚本到本地

    下载脚本, 或者创建一个文件复制文末脚本到文件, 修改文件名后缀以.sh结尾即可, 下载或者创建目录没有限制, 任意位置即可

    图片.png

    2. 到需要配置git 提交规范的项目根目录

    图片.png

    3. 执行脚本

    直接把脚本拖入终端,回车执行即可, 因为是第一次执行脚本,可能没有权限,会报错


    图片.png

    直接输入密码进行授权即可

    sudo chmod u+x 脚本
    
    图片.png

    授权完成, 执行脚本


    图片.png

    这里会再次让输入密码确认


    图片.png
    最后执行成功, 提交规范配置成功👏👏👏

    4.重启Sourcetree 提交改动

    先看下不规范的提交


    图片.png

    直接提交失败, 可根据弹窗中提示进行修改提交信息


    图片.png 图片.png

    修改/ 删除 git提交规范

    如果配置模板或者规范不满足自身需求, 可自行修改
    如果不想继续使用规范,可以进行卸载, 在脚本后面增加参数 uninstall 即可卸载

    图片.png
    #!/bin/bash
    
    ## 到项目跟目录执行该脚本
    ST_COMMIT_MSG=".stCommitMsg"
    
    COMMIT_MSG="commit-msg"
    GIT_HOOKS=".git/hooks"
    GIT_COMMIT_MSG="$GIT_HOOKS/$COMMIT_MSG"
    FIRST_DO="0"
    installGitRules() {
        whiteFile() {
            cat >>$ST_COMMIT_MSG <<EOF
    <type>(<scope>) : <subject>
    <body>
    <footer>
    EOF
        }
    
        pushd ~/
        if [ ! -f $ST_COMMIT_MSG ]; then
            echo "$ST_COMMIT_MSG file not exist"
            touch .stCommitMsg
            whiteFile
        else
            COPY_FILE="${ST_COMMIT_MSG}_backup"
            cp -P ~/$ST_COMMIT_MSG ~/$COPY_FILE
            : >$ST_COMMIT_MSG
            whiteFile
        fi
        popd
    
    
        writeCommitMsg() {
            cat >>.git/hooks/commit-msg <<EOF
    #!/bin/bash
    TIP_MESSAGE='
    <type>(<scope>) : <subject>\n
    <body>\n
    <footer>\n
    \n
    #type 本次修改功能类型\n
        .feat :新功能\n
        .fix :修复bug\n
        .opt :优化(optimize) 图片压缩, 文件删除等\n
        .ci : 版本号升级、branchConfig修改、scrip/podinfo.rb等发布相关修改\n
        .test :增加测试\n
    
        .refactor :某个已有功能重构\n
        .docs :文档改变\n
        .style :代码格式改变\n
        .revert :撤销上一次的 commit (revert 命令自动生成)\n
    \n
    #scope :用来说明此次修改的影响范围\n
        .all :表示影响面大 ,如修改了网络框架  会对真个程序产生影响\n
        .loation :表示影响小,某个小小的功能\n
        .module :表示会影响某个模块 如登录模块、首页模块 、用户管理模块等等\n
    \n
    #subject: 用来简要信息描述本次改动\n
    \n
    #body :具体的修改信息 应该尽量详细\n
    \n
    #footer :备注:  文档链接、bug id、设计文档\n
    '
    
    MSG=\$(awk '{printf("%s",\$0)}' \$1)
    if [[ \$MSG =~ ^(feat|fix|opt|ci|test|refactor|docs|style|revert)\(.*\):.*$ ]]; then
        echo -e " commit success!"
    else
        echo -e \MSG
        echo -e " Error: the commit message is irregular "
        echo -e " Error: type must be one of feat|fix|opt|ci|test|refactor|docs|style|revert"
        echo -e ' eg: feat(租房): 详情页增加无尽流'
        echo '详细文档👇👇👇'
        echo -e \$TIP_MESSAGE
        exit 1
    fi
    EOF
        }
    
        if [ ! -d $GIT_HOOKS ]; then
            pushd .git
            mkdir hooks
            mkfile -n 0b hooks/commit-msg
            popd
            writeCommitMsg
        else
            if [ ! -f $GIT_COMMIT_MSG ]; then
    
                mkfile -n 0b $GIT_COMMIT_MSG
                writeCommitMsg
            else
    
                COPY_FILE="${COMMIT_MSG}_backup"
                cp -P $GIT_COMMIT_MSG $GIT_HOOKS/$COPY_FILE
                : >$GIT_COMMIT_MSG
                writeCommitMsg
            fi
        fi
    
        sudo chmod 777 $GIT_COMMIT_MSG
        if [ $FIRST_DO != '0' ]; then
            echo 'Configuration is successful! 👏👏👏 '
            echo 'Restart Sourcetree then submit your changes!'
        fi
    }
    
    uninstallGitRules() {
        if [ ! -f $GIT_COMMIT_MSG ]; then
            echo "Don't have git commit message rules to remove!"
        else
            rm $GIT_COMMIT_MSG
            echo "remove git commit message rules success!"
        fi
    
        pushd ~/
        if [ ! -f $ST_COMMIT_MSG ]; then
            echo "$ST_COMMIT_MSG file not exist, Don't have git commit rules template to remove!"
        else
            rm $ST_COMMIT_MSG
            echo "remove git commit message rules template success!"
        fi
        popd
    
    }
    
    install() {
        installGitRules
        FIRST_DO="1"
        installGitRules
    }
    
    if [ $# == 0 ]; then
        install
        exit
    fi
    for i in "$*"; do
    
        if [ $i == "install" ]; then
            install
        elif [ $i == "uninstall" ]; then
            uninstallGitRules
        else
            install
        fi
    done
    
    

    相关文章

      网友评论

          本文标题:git commit 提交规范

          本文链接:https://www.haomeiwen.com/subject/zzirhrtx.html