掌握git命令的正确使用姿势
前言
最近在团队内部发起了一个小的python项目(用tkinter实现一个小工具),但是发现大家对git的使用还不太熟悉,不知道怎么同步代码、解决冲突等等。因为我觉得对测试工程师来说,git应该是必备技能,所以就帮大家整理下git最常用的命令及使用方法。
git的运用场景
- 写接口或者UI自动化,代码可以提交到gitlab(或github),方便维护和管理。
- 可以拉取开发的代码,进行白盒测试。
- 可以检查开发的代码提交记录,预防提测时开发提交非相关需求。
- 可以拉取github上的代码,学习别人的代码,便于己用。
git使用方法
为了便于大家理解,我就顺着平时的产品开发流程,结合具体的场景来介绍不同git命令的使用,假设现在有 A 和 B 两位同学一起开发一个新项目。
本地git配置:A、B两位同学都需要在本地对git进行配置,配置命令如下:
# 设置git的user name和email: $ git config --global user.name "xxx" $ git config --global user.email "xxx@gmail.com" # 配置ssh-key,然后一路回车 ssh-keygen -t rsa -C "xxxx@gmail.com"
这里对ssh-key做个说明,ssh-keygen是git自带的一个工具,执行上面的命令一路回车,会在~/.ssh/目录下生成id_rsa和id_rsa.pub。根据命名我们就可以看出以.pub结尾的是公钥,之后我们会将它配置到gitlab上;而id_rsa是私钥,只会存在你的本地。这一对公私钥的作用就是在访问gitlab服务器时,不需要输入密码,这样就可以方便的同步代码了(配置多个ssh-key的方法这里就不介绍了,大家可自行查询)。
【创建项目】:A同学首先去gitlab(github,公司一般都是自己搭建的gitlab)创建一个新的项目,比如叫projectA。创建方法其实比较傻瓜,只要登录到gitlab,就可以看到"New Project"的入口,跟着操作就好。
【初始化项目】:A同学在本地首先会初始化他们的项目(生成一部分初始化代码),比如目录是:/xuanke/code/projectA,然后通过命令行窗口,进入代码目录(以下命令全部在该目录下执行),执行如下命令:
$ cd /xuanke/code/projectA $ git init $ git remote add origin git@gitlab.xxx.com:xuanke/projectA.git
# 这里注意有空目录,默认git是不提交的,如果你想要提交空目录,需要增加如下操作(这句命令是将所有的空目录放到.gitkeep中):
# 另外需要注意,.gitkeep文件不要放到.gitignore文件中,要提交到git服务器上。
$ find . \( -type d -empty \) -and \( -not -regex ./\.git.* \) -exec touch {}/.gitkeep \; $ git add . $ git commit -m "初始化工程" $ git push -u origin master
【clone代码到本地】:B同学为了开发项目,需要将gitlab服务端代码同步到本地:
# 同步代码, -b是可选的,用-b可以指定分支,不写-b,默认从master拉取代码
$ git clone (-b dev) git@gitlab.xxx.com:xuanke/projectA.git
【切换分支】:A同学告诉B同学,我们先在dev分支开发吧,最后提测到qa分支,发布到rc分支,先切换到dev分支:
# 切换分支
$ git checkout dev
【提交代码】:B同学这时就开开心心的开始编码了,代码写完之后,得提交到gitlab服务器:
# 提交代码 $ git add . $ git commit -m "今天,我写了一个牛逼的功能" # 提交代码前一定要pull一下代码 $ git pull $ git push
这里说明一点:在执行git push命令之前的提交操作,都是在本地git缓存进行的,所以可以放心,不会影响到远端gitlab服务器代码。
【更新代码】:A同学得知B同学写了一个牛逼的功能,于是就想获取代码膜拜一下:
# 拉取同步gitlab服务器端最新的代码
$ git pull
【解决冲突】:A同学更新代码才发现,原来B同学也修改了Niubility.java文件,更新失败了,提示代码冲突了,这下爽歪歪了。不过千万别慌,我大概总结了下解决冲突的基本思路:
# 解决冲突方法 # 1. 首先找到冲突的文件,git 会提示你哪个文件冲突了。从网上拔了一段冲突日志(提示readme.txt冲突了): $ git merge feature1 Auto-merging readme.txt CONFLICT (content): Merge conflict in readme.txt Automatic merge failed; fix conflicts and then commit the result. # 2. 打开readme.txt文件,查找有 <<<<< 的地方。可以全局搜索 Git is a distributed version control system. Git is free software distributed under the GPL. Git has a mutable index called stage. Git tracks changes of files. <<<<<<< HEAD Creating a new branch is quick & simple. ======= Creating a new branch is quick AND simple. >>>>>>> feature1 # 3. HEAD和========之间代表我们当前本地的代码,==========到feature1之间代表远端的代码,我们根据代码的时机情况进行编辑。但是最后需要将 >>>>>>> <<<<<<< ======= 这些都删除掉。,比如修改为这样。 Git is a distributed version control system. Git is free software distributed under the GPL. Git has a mutable index called stage. Git tracks changes of files. Creating a new branch is quick AND simple. # 4. 再次提交代码: $ git commit -m "解决代码冲突" $ git push
【忽略提交某些文件】:A同学发现,每次提交代码都会将ide的配置文件提交,而且经常和B同学的同一个配置文件冲突,其实可以通过在项目目录下添加.gitignore文件来实现:
# 以Python文件为例: *.py[cod] *.so *.egg *.egg-info dist build
这里介绍个方法,假如你想忽略某个文件,但是该文件已经被提交到gitlab服务器了,该怎么办呢? 可以先将文件从本地git缓存删掉,再提交就可以从gitlab服务器删除掉了。
# 从本地git缓冲区删除文件fileName $ git rm --cached fileName
【合并分支】:A、B同学现在总共有四个分支:dev、qa、rc、master,现在他们开发完成了,需要将代码合并到qa分支提测了,该怎么操作呢?
# 首先,切换到qa分支
$ git checkout qa
# 其次,执行合并分支代码, 如果有冲突,参考上面解决冲突的流程
$ git merge dev
【其他常用命令】:上面基本已经涵盖了在工作中可能会用到的git命令,下面再整理一些其他常用命令:
# 能够查看本地的状况:有无修改提交的文件、都修改了哪些文件等等 $ git status # 查看历史提交记录 $ git log $ git log --author="xuanke" # 将某个分支的某条提交,合并到当前分支。(这个用的少一些,估计有些开发也没用过。) $ git cherry-pick 提交编号 # 删除本地的更改,回退到之前的版本,这个要谨慎操作 $ git reset --hard # 删除本地的某个分支 $ git branch -d dev # 切换并创建分支,主要加了-b参数 $ git checkout -b dev
总结
- 上面介绍了大部分常用的git命令,基本掌握这些就够用了。不过平时的工作中,应该多使用,这样才能熟能生巧,运用自如。
- 另外再强调下,一定要问开发要git的代码权限,哪怕看不懂,但起码也可以看他们每次提测的提交记录,这样可以知道都提交了哪些文件,修改了什么内容,可能会影响什么业务。之前碰到过非常荒唐的事情,开发一行代码都没改,就跟测试同学说:“你给我测一下吧”。所以,通过对git命令的掌握,可以帮助我们一定程度上提高提测的质量。