美文网首页
Git快速入门

Git快速入门

作者: mantou叔叔 | 来源:发表于2018-01-11 14:44 被阅读11次

    0. Git简介

    git是一个分布式版本控制软件,最初由林纳斯·托瓦兹(Linus Torvalds)创作,于2005年以GPL发布。最初目的是为更好地管理Linux内核开发而设计。Git可以在任何时间点,把文档的状态作为更新记录保存起来。因此可以把编辑过的文档复原到以前的状态,也可以显示编辑前后的内容差异。

    而且,编辑旧文件后,试图覆盖较新的文件的时候(即上传文件到服务器时),系统会发出警告,因此可以避免在无意中覆盖了他人的编辑内容。

    更多内容请查看Git维基百科。

    1. Git Vs SVN

    分布式 vs 集中管理 (多份版本库 vs 一份版本库,设想下版本服务器挂了?)
    无需网络,随时随地进行版本控制,在没有网络的情况下你想回退到某个版本svn基本没戏;
    分支的新建、合并非常方便、快速,没有任何成本,基本不耗时,svn的版本基本上等同于又复制了一份代码。

    stackoverflow 上关于svn和git的区别的讨论,说的很详细,请参考 Why is Git better than Subversion?

    Github上通过版本库结构、历史、子项目(submudle)的不同来对比两者,请参考Github的 What are the differences between SVN and Git?

    2.安装

    通过官网安装。

    下面推荐各个OS的GUI( 图形用户界面)Git工具,但还是强烈推荐使用命令行操作Git。

    • Windows
      乌龟Tortoisegit
      https://tortoisegit.org/

    • Mac
      免费的SourceTree客户端。
      http://www.sourcetreeapp.com/

    • Linux
      不推荐客户端,可以使用发行版包含的基础软件包管理工具来安装。 如果以 Fedora 上为例,你可以使用 yum:

    $ sudo yum install git
    

    如果你在基于 Debian 的发行版上,请尝试用 apt-get:

    $ sudo apt-get install git
    

    3. 配置

    Git 自带一个 git config 的工具来帮助设置控制 Git 外观和行为的配置变量。 这些变量存储在三个不同的位置:

    1. /etc/gitconfig 文件: 包含系统上每一个用户及他们仓库的通用配置。 如果使用带有 --system 选项的 git config 时,它会从此文件读写配置变量。

    2. ~/.gitconfig~/.config/git/config 文件:只针对当前用户。 可以传递 --global 选项让 Git 读写此文件。

    3. 当前使用仓库的 Git 目录中的 config 文件(就是 .git/config):针对该仓库。

    每一个级别覆盖上一级别的配置,所以 .git/config 的配置变量会覆盖 /etc/gitconfig 中的配置变量。

    在 Windows 系统中,Git 会查找 $HOME 目录下(一般情况下是 C:\Users\$USER)的 .gitconfig 文件。 Git 同样也会寻找 /etc/gitconfig 文件,但只限于 MSys 的根目录下,即安装 Git 时所选的目标位置。

    3.1 用户信息配置

    每一个 Git 的提交都会使用这些信息,并且它会写入到你的每一次提交中,不可更改:

    $ git config --global user.name "mantoudev"
    $ git config --global user.email mantoudev@163.com
    

    如果使用了 --global 选项,那么该命令只需要运行一次,因为之后无论你在该系统上做任何事情, Git 都会使用那些信息。 当你想针对特定项目使用不同的用户名称与邮件地址时,可以在那个项目目录下运行没有 --global 选项的命令来配置。

    很多 GUI 工具都会在第一次运行时帮助你配置这些信息。

    3.2 检查配置信息

    如果想要检查你的配置,可以使用 git config --list 命令来列出所有 Git 当时能找到的配置。

    $ git config --list
    user.name=mantoudev
    user.email=mantoudev@163.com
    color.status=auto
    color.branch=auto
    color.interactive=auto
    color.diff=auto
    ...
    

    你可能会看到重复的变量名,因为 Git 会从不同的文件中读取同一个配置(例如:/etc/gitconfig 与 ~/.gitconfig)。 这种情况下,Git 会使用它找到的每一个变量的最后一个配置。

    你可以通过输入 git config <key>: 来检查 Git 的某一项配置

    $ git config user.name
    mantoudev
    

    4. 基本常用命令

    4.1 添加文件到暂存区(staged)
    $ git add filename
     #或
    $ git stage filename
    
    4.2 将所有修改文件添加到暂存区(staged)
    $ git add --all
    #或
    $ git add -A
    
    4.3 提交修改到暂存区(staged)
    $ git commit -m 'commit message'
    $ git commit -a -m 'commit message'
    

    注意理解 -a 参数的意义

    4.4 从Git仓库中删除文件:
    $ git rm filename
    
    4.5 从Git仓库中删除文件,但本地文件保留:
    $ git rm --cached filename
    
    4.6 重命名某个文件:
    $ git mv filename newfilename
    #或者直接修改完毕文件名 ,进行
    $ git add -A && git commit -m 'commit message'
    

    Git会自动识别是重命名了文件

    4.7 获取远程最新代码到本地:
    $ git pull (origin branchname)
    

    可以指定分支名,也可以忽略。pull 命令自动 fetch 远程代码并且 merge,如果有冲突,会显示在状态栏,需要手动处理。更推荐使用:git fetch 之后 git merge --no-ff origin branchname 拉取最新的代码到本地仓库,并手动 merge 。

    5. Git commit messge规范

    查看Commit message

    $ git log <last tag> HEAD --pretty=format:%s
    
    

    5.0 Commit Message格式

    每次提交,Commit message 都包括三个部分:Header,Body 和 Footer。

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

    其中,Header 是必需的,Body 和 Footer 可以省略。
    不管是哪一个部分,任何一行都不得超过72个字符(或100个字符)。

    5.1 Header

    Header部分只有一行,包括三个字段:type(必需)、scope(可选)和subject(必需)。

    (1)type

    type用于说明 commit 的类别,只允许使用下面7个标识。

    • feat:新功能(feature)
    • fix:修补bug
    • docs:文档(documentation)
    • style: 格式(不影响代码运行的变动)
    • refactor:重构(即不是新增功能,也不是修改bug的代码变动)
    • test:增加测试
    • chore:构建过程或辅助工具的变动
    • revert: 撤销以前的 commit,后面跟着被撤销 Commit 的 Header。
    (2)scope

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

    (3)subject

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

    • 以动词开头,使用第一人称现在时,比如change,而不是changed或changes
    • 第一个字母小写
    • 结尾不加句号(.)

    5.2 Body

    Body 部分是对本次 commit 的详细描述,可以分成多行。下面是一个范例。

    此次修改主要对****功能模块进行重构,包含以下部分: 
    
    1. AAAAAAA....
    2. BBBBBBB....
    3. CCCCCCC....
    

    body中还可以与一些Bug管理工具进行关联,在Header之后换行添加

    Bug: <Bug编号>
    

    5.4 Footer

    (1)不兼容变动

    如果当前代码与上一个版本不兼容,则 Footer 部分以BREAKING CHANGE开头,后面是对变动的描述、以及变动理由和迁移方法。

    BREAKING CHANGE: isolate scope bindings definition has changed.
    
        To migrate the code follow the example below:
    
        Before:
    
        scope: {
          myAttr: 'attribute',
        }
    
        After:
    
        scope: {
          myAttr: '@',
        }
    
        The removed `inject` wasn't generaly useful for directives
    
    (2) 关闭 Issue

    如果当前 commit 针对某个issue,那么可以在 Footer 部分关闭这个 issue 。

    Closes #234
    
    
    (3) 签名

    如果commit使用签名的话,footer中会包含签名信息

    Signed-off-by: mantoudev <mantoudev@163.com>
    
    
    (4) 其他

    使用gerrit(代码审查工具,gerrit维基百科),在footer中会生成一个ChanggeId,一个ChangeId标识一次内容变化,可以包含多个commit,即多个commit如果changeid一致的话,可以认为是一个change。

    6. 参考资料

    1. Git-scm官方文档
    2. 猴子都能懂的Git系列
    3. Git学习资料汇总

    相关文章

      网友评论

          本文标题:Git快速入门

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