Git学习笔记(三)远程库(GitHub)协同开发,fork和忽略特殊文件

2023-02-15,,,,

远程库

  远程库,通俗的讲就是不再本地的git仓库!他的工作方式和我们本地的一样,但是要使用他就需要先建立连接!
  远程库有两种,一个是自己搭建的git服务器;另一种就是使用GitHub,这个网站就是提供Git仓库托管服务的,所以,只要注册一个GitHub账号,就可以免费获得Git远程仓库。友情提示:在GitHub上免费托管的Git仓库,任何人都可以看到喔(但只有你自己才能改)。所以,不要把敏感信息放进去。
  远程仓库的好处:
  1、我们可以随时随地的与仓库建立连接,以实时存放我们开发的内容;
  2、与他人实现协同开发,而不是再需要来回的发送修改过的代码由他人整合在一起,git自动的帮我们完成了更新,这是最重要的也是无可比拟的!
  3、只要你不把提交到本地仓库中的代码提交到远程库,那么别人一辈子也休想看到你的代码!

一、创建远程仓库(GitHub)

1、GitHub网站地址:https://github.com/,这个网站就是提供Git仓库托管服务的,所以,只要注册一个GitHub账号,就可以免费获得Git远程仓库。

2、由于本地Git仓库和GitHub仓库之间的传输是通过SSH加密的,所以,需要如下设置:

  第1步:创建SSH Key。在用户主目录下(例如:C:\Users\Administrator\),看看有没有.ssh目录,如果有,再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件,如果已经有了,可直接跳到下一步。如果没有,打开Shell(Windows下打开Git Bash),创建SSH Key:

ssh-keygen.exe //创建SSH key 【公钥和私钥,连接省却了用户名密码的输入】git窗口下,直接执行ssh-keygen.exe,默认往下执行,然后把公钥复制到github上

  如果一切顺利的话,可以在用户主目录里找到.ssh目录,里面有id_rsa和id_rsa.pub两个文件,这两个就是SSH Key的秘钥对,id_rsa是私钥,不能泄露出去,id_rsa.pub是公钥,可以放心地告诉任何人。
  第2步:登陆GitHub,打开“Account settings”,“SSH Keys”页面,然后,点“Add SSH Key”,填上任意Title,在Key文本框里粘贴id_rsa.pub文件的内容,最后点击“Add Key”按钮完成。
  说明:为什么GitHub需要SSH Key呢?因为GitHub需要识别出你推送的提交确实是你推送的,而不是别人冒充的,而Git支持SSH协议,所以,GitHub只要知道了你的公钥,就可以确认只有你自己才能推送。当然,GitHub允许你添加多个Key。
  假定你有若干电脑,你一会儿在公司提交,一会儿在家里提交,只要把每台电脑的Key都添加到GitHub,就可以在每台电脑上往GitHub推送了。

二、添加远程库:

1、登录GitHub网站,并按网站要求创建一个新的仓库;

2、根据GitHub网站提示,可以从这个仓库克隆出新的仓库,也可以把一个已有的本地仓库与之关联,然后,把本地仓库的内容推送到GitHub仓库。

3、本地仓库与GitHub上相应的仓库建立关联,代码如下:(git@github.com:zh605929205/LearnGit.git为我新建的仓库路径)

$ git remote add origin git@github.com:zh605929205/LearnGit.git

  添加后,远程库的名字就是origin,这是Git默认的叫法,也可以改成别的,但是origin这个名字一看就知道是远程库。

4、把本地库的内容推送到远程库上,用git push命令,实际是把当前分支master推送到远程。

$ git push -u origin master

  由于远程库是空的,我们第一次推送master分支时,加上了-u参数,Git不但会把本地的master分支内容推送的远程新的master分支,还会把本地的master分支和远程的master分支关联起来,在以后的推送或者拉取时就可以简化命令(不用带-u参数)。当然也可以不写!就需要你手动输入yes
  当你第一次使用Git的clone或者push命令连接GitHub时,会得到一个警告,这是因为Git使用SSH连接,而SSH连接在第一次验证GitHub服务器的Key时,需要你确认GitHub的Key的指纹信息是否真的来自GitHub的服务器,输入yes回车即可。

5、通过GitHub上的仓库来克隆出新的本地仓库(可以在任意一个文件夹下,建议最好在一个固定的盘下方便于管理),要克隆一个仓库,首先必须知道仓库的地址,然后使用 git clone命令克隆从远程库克隆到本地(说白了就是下载版本库)。代码如下:

$ git clone git@github.com:zh605929205/LearnGit.git	//应用场景:切换办公地点:家和公司,第一次都能从远程库上克隆然后进行开发!

  注意点:执行clone命令,实质上内部已经完成了初始化git库和本地与远程库连接的过程(内部config文件,已写好命名,同时远程库名字默认为origin)!

  也许还注意到,GitHub给出的地址不止一个,还可以用 https://github.com/zh605929205/LearnGit.git 这样的地址。实际上,Git支持多种协议,默认的git://使用ssh,但也可以使用https等其他协议。使用https除了速度慢以外,还有个最大的麻烦是每次推送都必须输入口令,但是在某些只开放http端口的公司内部就无法使用ssh协议而只能用https。Git支持多种协议,包括https,但通过ssh支持的原生git协议速度最快。

三、本地与远程库协同开发

1、查看远程库:

$ git remote
$ git remote -v //加上-v参数可以查看详细信息 ----> 显示了可以抓取和推送的origin的地址。如果没有推送权限,就看不到push的地址。

2、当本地更新完毕,提交到本地的版本库,要推送分支到远程库分支。推送分支,就是把该分支上的所有本地提交推送到远程库。推送时,要指定本地分支,这样,Git就会把该分支推送到远程库对应的远程分支上:

语法:$ git push origin 分支名
$ git push origin master // $ git push origin dev

  但是,并不是一定要把本地分支往远程推送,那么,哪些分支需要推送,哪些不需要呢?

    master分支是主分支,因此要时刻与远程同步;

    dev分支是开发分支,团队所有成员都需要在上面工作,所以也需要与远程同步;

    bug分支只用于在本地修复bug,就没必要推到远程了,除非老板要看看你每周到底修复了几个bug;

  总之,就是在Git中,分支完全可以在本地自己藏着玩,是否推送,视你的心情而定!

3、若是有多个分支,创建远程origin的dev分支到本地,需要创建本地分支并关联远程分支:

语法:$ git checkout -b 分支名 origin/分支名 //origin/dev为远程分支路径
$ git checkout -b dev origin/dev
$ git branch --set-upstream 分支名 origin/分支名 //若本地已有分支,可通过该命令来关联远程分支

4、从远程库中拉下分支新版本,用以更新本地库:

$ git pull origin 分支名

5、远程库推送解决冲突:

  多人协同开发,向远程推送提交时产生冲突【实质就是提交快慢的问题】,则需先用git pull把最新的提交从origin/dev抓下来,然后,在本地合并,解决冲突,再推送,如下:

$ git pull //从远程获取分支
$ git commit -m "marge files" //本地更新合并
$ git push origin dev //推送提交到远程分支

  注意:如果你在公司开发某段代码而忘记推送到远程库,别人又开发了别的功能并推送到远程库(此时远程库的版本已经与你本地库版本不一致),遇到这种情况,一定要记住先把远程库中对应的分支拉下来,然后再本地提交到版本库后,再重新推送到远程库!而且每次遇到解决冲突或是版本不一致的情况,一定要先看看是谁上一次做的操作,推送前一定要与其沟通!以免推送出错!

因此,多人协作的工作模式通常是这样:
  首先,可以试图用git push origin branch-name推送自己的修改;
  如果推送失败,则因为远程分支比你的本地更新,需要先用git pull试图合并;
  如果合并有冲突,则解决冲突,并在本地提交;
  没有冲突或者解决掉冲突后,再用 git push origin branch-name 推送就能成功!
  如果git pull 提示“no tracking information”,则说明本地分支和远程分支的链接关系没有创建,用命令git branch --set-upstream branch-name origin/branch-name 关联远程分支。

6、远程库的操作都是先克隆或是把程序拉到本地,然后在本地对代码进行修改,然后更新到本地版本库,再推送到远程库!这里边儿肯定是会涉及到分支的问题,在上一文中已经详细的说明了分支的操作!具体按照流程来即可!

Git本地库与远程库连接的补充说明

关于本地仓库与远程库建立第一次建立连接的问题!
1、本地库提交到远程库!(本地库有数据而远程库没有数据)
第一步,先在远程库创建一个仓库(默认是master分支),用于上传你本地仓库内的所有文件!
第二步,在你本地仓库执行以下命令,以和远程库建立连接(先获取你远程库的ssh or https的远程库路径)
git remote add origin 【远程库的ssh or https协议路径】//此处远程库名可以自定义任意取名!
第三步,把本地库的代码提交到远程库!
此处场景:你在本地有两个分支,业务线master分支和开发dev分支
1)先提交master分支
git branch //查看是否在master不是切换到master分支
git checkout master
git push origin master //推送
2)再提交dev分支
git checkout dev
git branch //查看当前分支
git push origin dev //推送
第四步,推送成功之后,在远程库查看两条分支是否都在,都在的话证明提交成功!
2、远程库所有分支下载到本地(远程库有数据而本地库没有)
第一步,登录你的远程库,找到要下载的库名,点击进去找到 Clone or download 绿色的按钮,点击获取当前远程库的ssh or https协议的地址,获取这个地址;
第二步,在你的本地及你的电脑上找一地儿,创建一个自认为名字很帅的文件夹,点进去右击点 git bash here 等待一个git的窗口模式出现;
第三步:克隆你的远程库到本地,在窗口执行以下命令:
git clone【ssh or https 的地址】 //注:克隆下来的第一个分支,铁定是master分支!
等待完成,本地工作区会出现和远程库相同的master的所有文件
git branch //查看本地分支,会发现只有 master分支
git branch -a //可以查看远程库有几个分支,及当前指针所在分支!
第三步,下载其他分支例如开发分支,执行以下命令:
git checkout -b dev origin/dev //创建并切换到dev分支同时与远程分支关联,获取远程分支内的所有数据
第四步,等待完成,查看dev分支内工作区与远程库dev分支内容是否一致! 当本地库与远程库建立连接,分支都已同步之后,剩下的推送版本或是下载版本就都是很简单了!
1、在本地修改文件,提交到本地版本库,再从本地版本库上传到远程库就是用命令
git push origin dev //(注意你推送的分支)
2、从远程库分支获取文件更新你的本地版本
git pull origin dev //(注意你拉取的分支)

协同开发

  1个远程库,多个人员使用,同时对某个业务线进行开发!

  既然要实现协同开发,那么一个人铁定是不行的。就需要创建组织,然后再对这个组件进行管理添加成员,点进去这个库,在people栏下点击邀请开发人员!发送邀请的同时可以对这个开发人员进行权限分配,以限制其都能有什么权限!

  注意:非组织成员是不允许对这个仓库进行操作的!

  协同开发的时候,共同使用一个项目,当需要对这个远程库提交的时候,一定是先进行拉取操作,然后再提交!否则就会因为版本库内代码不一致的问题导致报错或是紊乱!

  两人未沟通的情况下同时提交代码到远程库,肯定是得取决于谁提交的快谁会提交到远程库!提交慢的人会被拒绝,就是因为慢的原因!所以如果遇到这种被拒绝的情况,不用惊慌,你先把远程库的代码拉取下来,然后你再提交一次就OK了!【注意:解决冲突的时候,一定要先与上一个提交的人先沟通!】

奉上一张相关错误截图,借用的老师的图片,当遇到这个问题时,一定是版本冲突的问题!把远程库的代码拉下来,重新提交就OK!

四、参与开源项目 fork

1、首先你自己必需要有GitHub账号并已登录成功。

2、找到指定的开源项目GitHub地址,例如:

3、点击图上的Fork按钮,会在自己账号下克隆一个相同的仓库,例如:

4、使用git clone命令克隆到本地仓库,如:

$ git clone git@github.com:wheeky/learngit.git

5、在本地进行相应的操作,比如新增了一个文件(CTextBox.cs):

$ git add CTextBox.cs
$ git commit -m 'add CTextBox.cs'

6、使用git push命令推送更新到远程仓库:

$ git push origin master

此时远程仓库就可以看到相应的更新(红色框内显示最后提交的信息),如图:

7、创建pull request请求,向开源项目的作者发送更新请求,如下列图示:

  点击“New pull request”按钮,并在随后的页面里填写相应的标题、备注说明等信息提交即可,剩下的就是等原作者的处理。若提交成功可在作者的开源项目的Pull requests中可以看到自己请求记录,如下:

五、忽略特殊文件

  在Git工作区的根目录下创建一个特殊的.gitignore文件,然后把要忽略的文件名填进去(按照规则填写),Git就会自动忽略这些类型的文件。不需要从头写.gitignore文件,GitHub已经为我们准备了所有语言的各种配置文件,只需要找到python的文件,组合一下就可以使用了。所有配置文件可以直接在线浏览https://github.com/github/gitignore

  注意:.gitignore文件本身要放到版本库里,并且可以对.gitignore做版本管理!

Git学习笔记(三)远程库(GitHub)协同开发,fork和忽略特殊文件的相关教程结束。

《Git学习笔记(三)远程库(GitHub)协同开发,fork和忽略特殊文件.doc》

下载本文的Word格式文档,以方便收藏与打印。