Git实际开发使用总结

前言

1. 本文用于记录在实际开发中使用到的git操作。
2. 当前笔者的操作环境是macOS 10.13.6，git版本是2.15.1，使用的git服务器是GitLab。
3. 通过本文你会得到下面这些东西：
   • 使用tab键自动补全git命令；
   • 使用SSH来登录你的git账号；
   • 忽略文件.gitignore；
   • 为版本添加tag；
   • GitLab用户权限；

使用tab键自动补全git命令

注：这里仅限mac系统

亲自可以的方法

1. 去下载官方的补全文件，下载地址。

   PS：

   (1) 我没有下载那个文件，因为没找到在哪有下载的按钮。所以直接点解“RAW”进行在线预览，如果当前文件不能在线预览，就会自动下载。预览后，直接全文复制，后面再在本地新建文件进行粘贴。

   (2) 一定要先看下自己电脑的git版本，补全文件必须要和自己Git的版本匹配。比如我的Git版本是2.15.1，那么打开补全文件的Github地址，然后点击左侧的Branch，切换到Tags，然后选择与你Git版本相对应的tag。然后在复制补全文件。如下图：
   

   

   选择对应的补全文件

2. 切换到当前用户的home路径下，如我的是/Users/zhangguiyou

3. 把刚才下载的文件移动到这里。PS：我没有下载上面的那个文件，而是直接copy了文件的内容，然后在home下使用vim（vim不会用的话，参照Linux下的命令大全）新建了一个.git-completion.bash文件，并把官方文件的内容copy进去。然后保存退出。

4. 让刚才的补全文件生效。输入命令:source ~/git-completion.bash（~/git-completion.bash的路径是绝对路径，所以你可以在任意目录下执行），其中的文件名就是上面那个文件的文件名.

5. 这样就可以自动补全了。不过每一次开机都需要执行一遍source ~/git-completion.bash。下面我们把这个命令加入到开机启动项中.

6. 打开当前用户的home路径下的.bash_profile文件。如果没有的话，就用vim新建一个。

7. 然后按i键进入编辑模式，把source ~/git-completion.bash添加上去。然后esc→：wq保存退出。

8. 完成。

失败的方法

下面是我试过之后失败的方法：
使用HomBrew安装git-completion，然后在~/.bash_profile中添加

if [ -f $(brew --prefix)/etc/bash_completion ]; then
  . $(brew --prefix)/etc/bash_completion
fi

使用SSH来登录你的git账号

基本介绍

SSH安全认证协议，也称为公钥。类似于接头暗号。有了SSH你在向git服务器请求代码的时候就不需要用户名和密码了。前提是这个SSH在GIT 服务器上注册了（类似于把你的ssh加入到了这个项目的版本控制）。

Linux和Mac上的SSH目录

1. SSH公钥默认被存储在~/.ssh目录下。可以先cd ~/.ssh，然后ls查看该路径下的问题件。
2. 如果已经设置过公钥的好，在~/.ssh目录下应该会有something 和 something.pub 来命名的一对文件，这个 something 通常就是 id_dsa 或 id_rsa。有 .pub 后缀的文件就是公钥，另一个文件则是密钥。
3. 如果没有这些文件，或者连.ssh都没有，那么说明还没有生产过SSH。可以用下面介绍的命令来生产。

生成SSH公钥

1. 在Linux或者Mac上使用ssh-keygen命令。
2. 它先要求你确认保存公钥的位置（.ssh/id_rsa），然后它会让你重复一个密码两次，如果不想在使用公钥的时候输入密码，可以留空。
3. 完成后，再回到~/.ssh路径下，就有id_dsa和 id_dsa.pub文件了。
4. 我们只需要复制 .pub 文件的内容然后发邮件给管理员，这样访问git服务器的时候就不需要输入用户名密码也可以拉取最新的代码了。
5. .pub里面的内容大概长这个样子：

$ cat ~/.ssh/id_rsa.pub ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAklOUpkDHrfHY17SbrmTIpNLTGK9Tjom/BWDSU GPl+nafzlHDTYW7hdI4yZ5ew18JH4JW9jbhUFrviQzM7xlELEVf4h9lFX5QVkbPppSwg0cda3 Pbv7kOdJ/MTyBlWXFCR+HAo3FXRitBqxiX1nKhXpHAZsMciLq8V6RjsNAQwdsdMFvSlVK/7XA t3FaoJoAsncM1Q9x5+3V0Ww68/eIFmb1zuUFljQJKprrX88XypNDvjYNby6vw/Pb0rwert/En mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx NrRFi9wrf+M7Q== [email protected]

在GitLab上添加你的SSH

1. 打开你的GitLab用户界面。然后点击右上角头像，在弹出窗中选择Profile Settings。
2. 打开Profile Settings之后，切换到SSH Keys标签。
3. 在“key”里粘贴.pub里的那串字符，在“title”里写上SSH key所在机器的名字。住：一般一台机器有唯一的SSH key。title的目的能标识出哪台电脑，日后换电脑删除SSH Key的时候直接根据title来删除就可以了。
4. 填完key和title之后，点击“Add Key”就可以了。

5. 测试一下，在电脑上就可以以对应gitlab账号来clone和提交代码了。

   
   
   

   GitLab配置SSH Keys

忽略文件

整个工程的代码，可能有一部分我们不希望加入Version Control。那么就需要根据需求来忽略相关文件。我们在为工程添加Git版本控制的时候，会生成一个.gitignore文件（如果没有，可以自己添加）。我们只要把忽略规则添加到这个文件里就可以了。

忽略文件的编写

默认是以.gitignore文件所在的路径为根目录。

1. 忽略指定后缀名的文件。比如忽略所有.iml结尾的文件：*.iml。
2. 忽略指定的一个问题件。比如忽略根目录下的local.properties文件：/local.properties。
3. 忽略整个文件夹。比如忽略根目录下的build文件夹：/build。

忽略规则（Android版本）

一般新建工程的时候，会自动生成忽略文件。里面已经把不需要添加到版本控制的

忽略文件不生效

1. 描述：已经正确配置了忽略文件，但是依然会被git上传。

2. 原因：有缓存

3. 解决办法：先把本地缓存删除（改变成未被追踪状态），然后再提交。直接使用下面三行代码就可以：

   git rm -r --cached .
   git add .
   git commit -m 'update .gitignore'
   

为版本添加Tag

为什么要用Tag

1. 我们一般会在dev分支上进行开发。开发结束、测试完成后会合并到master并进行发版。
2. 随着版本的迭代，master上的提交记录会非常多。我们怎么定位某一个版本发版时的那个节点呢？这就用到了Tag标签。
3. 我们通过在发版的commit上添加一个tag，日后就可以直接通过tag来checkout到对应的那次commit。就告别了在浩瀚提交记录中查找某次发版记录的烦恼。

相关命令

命令	解释
git tag	列出所有标签。仅仅是标签名，没有注释
git tag -l -n	列出所有的标签，以及注释
git tag -l 'v1.4.2.*'	列出所有和v1.4.2相关的tag
git show v1.4	查看某个版本的tag信息，如查看v1.4版本
git tag 标签名称	创建一个轻量级的标签，如git tag v1.4-lw
git tag -a 标签名称 -m '注解内容'	创建一个含注解的标签，git tag -a v1.4 -m 'my version 1.4'
git checkout tag名	以新分支的方式切换到指定的Tag。
git tag -d tag名	删除本地的一个tag。例如git tag -d v3.1.0
git push origin :refs/tags/标签名	删除远程tag

给之前的某次提交添加tag

先通过git log 查看到某次提交的commit id，然后按照正常打标签的方式，在最后跟上commit id就可以了。如：给commit id开头是9fceb02的提交添加一个标签，
$ git tag -a v1.2 9fceb02

将本地Tag push到远程服务器

默认打的tag都是打在本地。即普通的push方法，push到远程分支，是不包含tag的。如果希望把tag一起push到远程，那么可以使用下面的命令去push：

1. push单个tag，格式：git push origin [tagname]
   举例：git push origin v1.0 #将本地v1.0的tag推送到远端服务器
2. push所有的tag，格式：git push [远程服务器名] --tags。举例：git push --tags 或 git push origin --tags如果带远程服务器的名，那就是推送到指定服务器。如果不带，那就用默认关联的。

GitLab用户权限

用户权限

1. 根据权限的不同，将用户分为：Guest、Reporter、Developer、Master、Owner五种角色。
2. 不同角色对应不同的权限。
   • Guest：游客。可以创建issue、发表评论，不能读写版本库
   • Reporter：可以克隆代码，不能提交，QA、PM可以赋予这个权限
   • Developer：可以克隆代码、开发、提交、push，RD可以赋予这个权限
   • master：可以创建项目、添加tag、保护分支、添加项目成员、编辑项目，核心RD负责人可以赋予这个权限
   • Owner：可以设置项目访问权限 - Visibility Level、删除项目、迁移项目、管理组成员，开发组leader可以赋予这个权限

项目权限

1. 在GitLab上创建一个新Project时，会让我们设置该项目的权限。

   
   
   

   项目权限
2. 三种权限的区别：
   • Private：只有组成员才能看到
   • Internal：只要登录的用户就能看到
   • Public：所有人都能看到