一、注册GITHUB帐号(如果有可省略)
二、找到开源项目并在右上角FORK
三、克隆到本地
注意,克隆的是FORK来的,即在自己的地址下,否则你没有提交代码的权限。
git clone xxxxxxx.git
四、创建一个分支
这里提议创建一个分支,这样处理起来也方便,主要是提交完成后,不管有没有成功都可以把这个分支强行删除。
git checkout –b branch_name
五、找到问题并修改代码,提交
这个就好说了:
git add –u 或者git add .
git commit –m”xxxxxxx”
git push
此处如果有问题,看最后的说明
六、pull request
点击红框内的按钮,弹出一个框,填写相关的说明,提交。这里需要注意的是,只有第一次会有这个,第二次以后就没有了,需要点击提交的列表,也会出现弹框,然后继续即可。
GitHub 关键词:当使用 fix(es),close(s) 或 resolve(s) 时,如果这个 Pull Request 被合并,会自动关闭对应的 Issue。这里我标出了 Closes #1300,那么当我们贡献的代码被接受时,就会关闭 rational-numbers: implement exercise 这个 Issue。正确地使用 GitHub 关键词能够极大地方便仓库维护者,他们就不需要去查找对应的是哪个 Issue 并去手动关闭它了。
七、评审和合并
需要说明的是,这一段并不属于贡献方的事,到六为止,贡献方的工作基本就完成了。
在GITHUB的维护者界面上,在有人Pull Request后,会出现一个提示,打开,评审,如果合适合并,不合适否决。
八、保持Fork的代码同步
开源的代码,特别是热门的代码可能每天更新,所以保持最新的代码是必要的:
首先查看一下目前有哪些远程仓库:
这个里面已经增加了更新的代码库,可以把后两个部分忽略。
假设忽略后两部分,则可以新增:
git remote add upstream https://github.com/fjfdbf/IirsProjectNetWrok.git
这时可以进行一下测试:
进入到fjfdbf/IirsProjectNetWork,修改相关文件:
然后在本地的GIT CMD中:
git branch –a
git checkout –b master
git fetch upstream
git merge upstream/master
查看当前分支,并保持在主分支上,更新最新的代码,并合并到本地的master(可以直接pull upstream/master虽然成功,但总报要设定一个默认分支,记得一定要切换到master上去)
最后 :git push
将本地的master分支推送到自己的远端分支上。
九、切换到远端分支(注意不是创建分支):
git branch –a 或者 git branch –r
git checkout –b mylocal_branch(本地分支名) origin/remote_branch(远端分支名)
说明:本地分支名和远端分支名可以保持一致即名称一样。举例:
git checkout –b develop origin/develop
或者:
如果远端已经存在分支,则直接切换:
git checkout xxx(分支名称)
git pull
不一定非得按网上所说:
git checkout -b xxx origin/xxx
十、查看远端的地址:
git remote –v
或
git remote show origin
后者更详细一些
应用到的git相关的命令:
十一、设置新的仓库地址
git remote set-url origin git@xxx.xxx.xxx.xxx:ch/xxx.xxx.git
十二、删除远端分支
$ git push origin :localbranch
推送定个空的分支到远端,即删除远端分支
也可以使用:
$ git push origin --delete localbranch
这两种方式都可以删除指定的远程分支
十三、创建分支后远端提交:
创建新的分支:
git checkout -b master-fjf
连接到远端的方法有两种:
1、直接推送到远程分支:
git push origin master-fjf:master-fjf
说明:这种连接后只是把分支推送到远端,但仍然无法提交,提交方法见下面第二种方法
2、连接二者(否则不能提交):
git push --set-upstream origin master-fjf
或:git push –u origin master-fjf -u等同于--set-upstream
这种方法可以直接略过第一种方法,并且可以提交,建议直接使用第二种方法。
或者:
git branch --set-upstream-to=origin/master-fjf
git branch --set-upstream origin master-fjf
3、取消对master的跟踪
git branch --unset-upstream master
十四、测试库的流程例子:
来看一下实际的操作:
D:\IirsProjectNetWork>git remote -v
origin https://github.com/fpcfjf/IirsProjectNetWork.git (fetch)
origin https://github.com/fpcfjf/IirsProjectNetWork.git (push)
D:\IirsProjectNetWork>git remote add
upstream https://github.com/fjfdfb/IirsProjectNetWork.git
D:\IirsProjectNetWork>git remote -v
origin https://github.com/fpcfjf/IirsProjectNetWork.git (fetch)
origin https://github.com/fpcfjf/IirsProjectNetWork.git (push)
upstream https://github.com/fjfdfb/IirsProjectNetWork.git (fetch)
upstream https://github.com/fjfdfb/IirsProjectNetWork.git (push)
D:\IirsProjectNetWork>git pull upstream
remote: Enumerating objects: 11, done.
remote: Counting objects: 100% (11/11), done.
remote: Compressing objects: 100% (7/7), done.
remote: Total 7 (delta 2), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (7/7), done.
From https://github.com/fjfdfb/IirsProjectNetWork
* [new branch] master -> upstream/master
You asked to pull from the remote 'upstream', but did not specify
a branch. Because this is not the default configured remote
for your current branch, you must specify a branch on the command line.
D:\IirsProjectNetWork>git fetch upstream
D:\IirsProjectNetWork>git merge upstream/master
Updating 60330a8..08d7c89
Fast-forward
base.txt | 9 +++++++++
1 file changed, 9 insertions(+)
D:\IirsProjectNetWork>git push
Counting objects: 7, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (7/7), done.
Writing objects: 100% (7/7), 1.95 KiB | 997.00 KiB/s, done.
Total 7 (delta 2), reused 0 (delta 0)
remote: Resolving deltas: 100% (2/2), completed with 1 local object.
To https://github.com/fpcfjf/IirsProjectNetWork.git
60330a8..08d7c89 master -> master