Git的正确使用姿势与最佳实践(上)| 青训营

114 阅读5分钟

Git的正确使用姿势与最佳实践(上)

在实际开发中,会使用git作为版本控制工具来完成团队协作。因此,对基本的git操作指令进行总结是十分有必要的,本文对一些术语或者理论基础做归纳总结。

目录

分支管理
提交代码
撤销代码
远程仓库协作

分支管理

  • 主分支(通常是master或main)应保持稳定和可发布状态。
  • 开发新功能或修复错误时,应从主分支切出新的特性分支或修复分支。
  • 完成开发或修复后,使用合并(merge)或重播(rebase)将更改合并回主分支。
创建分支:git branch <branch-name>,如git branch testing;
从当前所处的分支切换到其他分支:git checkout <branch-name>,如git checkout testing;
新建并切换到新建分支上:git checkout -b <branch-name>;
删除分支:git branch -d <branch-name>;
将当前分支与指定分支进行合并:git merge <branch-name>;
显示本地仓库的所有分支:git branch;
查看各个分支最后一个提交对象的信息:git branch -v;
查看哪些分支已经合并到当前分支:git branch --merged;
查看当前哪些分支还没有合并到当前分支:git branch --no-merged;
把远程分支合并到当前分支:git merge <remote-name>/<branch-name>,如git merge origin/serverfix;如果是单线的历史分支不存在任何需要解决的分歧,只是简单的将HEAD指针前移,所以这种合并过程可以称为快进(Fast forward),而如果是历史分支是分叉的,会以当前分叉的两个分支作为两个祖先,创建新的提交对象;如果在合并分支时,遇到合并冲突需要人工解决后,再才能提交;
在远程分支的基础上创建新的本地分支:git checkout -b <branch-name> <remote-name>/<branch-name>,如git checkout -b serverfix origin/serverfix;
从远程分支checkout出来的本地分支,称之为跟踪分支。在跟踪分支上向远程分支上推送内容:git push。该命令会自动判断应该向远程仓库中的哪个分支推送数据;在跟踪分支上合并远程分支:git pull;
将一个分支里提交的改变移到基底分支上重放一遍:git rebase <rebase-branch> <branch-name>,如git rebase master server,将特性分支server提交的改变在基底分支master上重演一遍;使用rebase操作最大的好处是像在单个分支上操作的,提交的修改历史也是一根线;如果想把基于一个特性分支上的另一个特性分支变基到其他分支上,可以使用--onto操作:git rebase --onto <rebase-branch> <feature branch> <sub-feature-branch>,如git rebase --onto master server client;使用rebase操作应该遵循的原则是:一旦分支中的提交对象发布到公共仓库,就千万不要对该分支进行rebase操作;

提交代码

  • 提交之前应经常进行代码审查(code review)。
  • 提交应是逻辑上独立的单元,具有清晰的目的,并遵循良好的编码规范。
  • 提交消息应清晰、简明地描述所做的更改。
提交工作区所有文件到暂存区:git add .
提交工作区中指定文件到暂存区:git add <file1> <file2> ...;
提交工作区中某个文件夹中所有文件到暂存区:git add [dir];

撤销代码

  • 删除工作区文件,并且也从暂存区删除对应文件的记录:git rm ;
  • 从暂存区中删除文件,但是工作区依然还有该文件:git rm --cached ;
  • 取消暂存区已经暂存的文件:git reset HEAD ...;
  • 撤销上一次对文件的操作:git checkout --。要确定上一次对文件的修改不再需要,如果想保留上一次的修改以备以后继续工作,可以使用stashing和分支来处理;
  • 隐藏当前变更,以便能够切换分支:git stash;
  • 查看当前所有的储藏:git stash list;
  • 应用最新的储藏:git stash apply,如果想应用更早的储藏:git stash apply stash@{2};重新应用被暂存的变更,需要加上--index参数:git stash apply --index;
  • 使用apply命令只是应用储藏,而内容仍然还在栈上,需要移除指定的储藏:git stash drop stash{0};如果使用pop命令不仅可以重新应用储藏,还可以立刻从堆栈中清除:git stash pop;
  • 在某些情况下,你可能想应用储藏的修改,在进行了一些其他的修改后,又要取消之前所应用储藏的修改。Git没有提供类似于 stash unapply 的命令,但是可以通过取消该储藏的补丁达到同样的效果:git stash show -p stash@{0} | git apply -R;同样的,如果你沒有指定具体的某个储藏,Git 会选择最近的储藏:git stash show -p | git apply -R;

远程仓库协作

  • 定期从远程仓库(origin)拉取最新的代码(pull)。
  • 在推送代码之前,确保本地代码与远程仓库保持同步(fetch/merge/rebase)。
  • 避免在主分支上直接提交代码,使用分支进行开发和修复,并定期将其合并回主分支。
将工作区中的项目文件使用git进行管理,即创建一个新的本地仓库:git init;
从远程git仓库复制项目:git clone <url>,
如:git clone git://github.com/wasd/example.git;
克隆项目时如果想定义新的项目名,可以在clone命令后指定新的项目名:git clone git://github.com/wasd/example.git mygit;

写在最后

本文对Git的正确使用姿势与最佳实践进行了初步的总结,更多的会在后续文章。