前言
- 本文用于记录在实际开发中使用到的git操作。
- 当前笔者的操作环境是macOS 10.13.6,git版本是2.15.1,使用的git服务器是GitLab。
- 通过本文你会得到下面这些东西:
- 使用tab键自动补全git命令;
- 使用SSH来登录你的git账号;
- 忽略文件.gitignore;
- 为版本添加tag;
- GitLab用户权限;
使用tab键自动补全git命令
注:这里仅限mac系统
亲自可以的方法
-
去下载官方的补全文件,下载地址。
PS:
(1) 我没有下载那个文件,因为没找到在哪有下载的按钮。所以直接点解“RAW”进行在线预览,如果当前文件不能在线预览,就会自动下载。预览后,直接全文复制,后面再在本地新建文件进行粘贴。
(2) 一定要先看下自己电脑的git版本,补全文件必须要和自己Git的版本匹配。比如我的Git版本是2.15.1,那么打开补全文件的Github地址,然后点击左侧的Branch,切换到Tags,然后选择与你Git版本相对应的tag。然后在复制补全文件。如下图:
切换到当前用户的home路径下,如我的是/Users/zhangguiyou
把刚才下载的文件移动到这里。PS:我没有下载上面的那个文件,而是直接copy了文件的内容,然后在home下使用vim(vim不会用的话,参照Linux下的命令大全)新建了一个.git-completion.bash文件,并把官方文件的内容copy进去。然后保存退出。
让刚才的补全文件生效。输入命令:
source ~/git-completion.bash
(~/git-completion.bash的路径是绝对路径,所以你可以在任意目录下执行),其中的文件名就是上面那个文件的文件名.这样就可以自动补全了。不过每一次开机都需要执行一遍source ~/git-completion.bash。下面我们把这个命令加入到开机启动项中.
打开当前用户的home路径下的.bash_profile文件。如果没有的话,就用vim新建一个。
然后按i键进入编辑模式,把
source ~/git-completion.bash
添加上去。然后esc→:wq保存退出。完成。
失败的方法
下面是我试过之后失败的方法:
使用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目录
- SSH公钥默认被存储在~/.ssh目录下。可以先
cd ~/.ssh
,然后ls
查看该路径下的问题件。 - 如果已经设置过公钥的好,在~/.ssh目录下应该会有something 和 something.pub 来命名的一对文件,这个 something 通常就是 id_dsa 或 id_rsa。有 .pub 后缀的文件就是公钥,另一个文件则是密钥。
- 如果没有这些文件,或者连.ssh都没有,那么说明还没有生产过SSH。可以用下面介绍的命令来生产。
生成SSH公钥
- 在Linux或者Mac上使用ssh-keygen命令。
- 它先要求你确认保存公钥的位置(.ssh/id_rsa),然后它会让你重复一个密码两次,如果不想在使用公钥的时候输入密码,可以留空。
- 完成后,再回到~/.ssh路径下,就有id_dsa和 id_dsa.pub文件了。
- 我们只需要复制 .pub 文件的内容然后发邮件给管理员,这样访问git服务器的时候就不需要输入用户名密码也可以拉取最新的代码了。
- .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== schacon@agadorlaptop.local
在GitLab上添加你的SSH
- 打开你的GitLab用户界面。然后点击右上角头像,在弹出窗中选择
Profile Settings
。 - 打开
Profile Settings
之后,切换到SSH Keys
标签。 - 在“key”里粘贴.pub里的那串字符,在“title”里写上SSH key所在机器的名字。住:一般一台机器有唯一的SSH key。title的目的能标识出哪台电脑,日后换电脑删除SSH Key的时候直接根据title来删除就可以了。
- 填完key和title之后,点击“Add Key”就可以了。
-
测试一下,在电脑上就可以以对应gitlab账号来clone和提交代码了。
忽略文件
整个工程的代码,可能有一部分我们不希望加入Version Control。那么就需要根据需求来忽略相关文件。我们在为工程添加Git版本控制的时候,会生成一个.gitignore文件(如果没有,可以自己添加)。我们只要把忽略规则添加到这个文件里就可以了。
忽略文件的编写
默认是以.gitignore文件所在的路径为根目录。
- 忽略指定后缀名的文件。比如忽略所有.iml结尾的文件:
*.iml
。 - 忽略指定的一个问题件。比如忽略根目录下的local.properties文件:
/local.properties
。 - 忽略整个文件夹。比如忽略根目录下的build文件夹:
/build
。
忽略规则(Android版本)
一般新建工程的时候,会自动生成忽略文件。里面已经把不需要添加到版本控制的
忽略文件不生效
描述:已经正确配置了忽略文件,但是依然会被git上传。
原因:有缓存
-
解决办法:先把本地缓存删除(改变成未被追踪状态),然后再提交。直接使用下面三行代码就可以:
git rm -r --cached . git add . git commit -m 'update .gitignore'
为版本添加Tag
为什么要用Tag
- 我们一般会在dev分支上进行开发。开发结束、测试完成后会合并到master并进行发版。
- 随着版本的迭代,master上的提交记录会非常多。我们怎么定位某一个版本发版时的那个节点呢?这就用到了Tag标签。
- 我们通过在发版的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:
- push单个tag,格式:
git push origin [tagname]
举例:git push origin v1.0
#将本地v1.0的tag推送到远端服务器 - push所有的tag,格式:
git push [远程服务器名] --tags
。举例:git push --tags
或git push origin --tags
如果带远程服务器的名,那就是推送到指定服务器。如果不带,那就用默认关联的。
GitLab用户权限
用户权限
- 根据权限的不同,将用户分为:Guest、Reporter、Developer、Master、Owner五种角色。
- 不同角色对应不同的权限。
- Guest:游客。可以创建issue、发表评论,不能读写版本库
- Reporter:可以克隆代码,不能提交,QA、PM可以赋予这个权限
- Developer:可以克隆代码、开发、提交、push,RD可以赋予这个权限
- master:可以创建项目、添加tag、保护分支、添加项目成员、编辑项目,核心RD负责人可以赋予这个权限
- Owner:可以设置项目访问权限 - Visibility Level、删除项目、迁移项目、管理组成员,开发组leader可以赋予这个权限
项目权限
-
在GitLab上创建一个新Project时,会让我们设置该项目的权限。
- 三种权限的区别:
- Private:只有组成员才能看到
- Internal:只要登录的用户就能看到
- Public:所有人都能看到