如何加入github开源项目!

Dear 丶 2022-05-17 03:51 278阅读 0赞

1、首先登陆到[https://github.com][https_github.com]平台上注册一个自己的账号。

![Image 1][]

2，然后在左上部分输入一个开源项目的名字,我选择的是jvalidator,回车搜索。

![Image 1][]

3,在搜索结果页面找到如下如图所示的项目，单击项目名称。

![Image 1][]

4,此时，你已经进入到了rinh/jvalidator的项目主页了，单击右上角的fork按钮，就把这个项目拉到你的账户下了，你就可以加入到这个项目中了。github就会在你的帐户下fork一个同样的备份。

@**查看自己名下的fork项目**

![Image 1][]

进入自己的主页，点击‘repositories’，就可以查看到fork后的项目。

点击项目名称链接进入该项目的主页。

![Image 1][]

这相当于你私人的仓库；你以后的项目修改、提交和贡献都在这个仓库中进行。

**@ 修改项目内容**

项目的源码同步到本地后，就可以开始为项目做贡献了。你可以根据需求修改、增加相应的文件、内容等，直到功能添加、修改并调试完毕。

5，此时，页面已经跳转到你的账户下的jvalidator项目里了，单击右下方的复制按钮，将这个地址就复制下来了，稍后有用。

![Image 1][]

6，此时，你需要安装一个git的客户端工具，当然这就很多了，我们演示就用它了[http://msysgit.github.io][http_msysgit.github.io]，到这个页面下载此工具,选择一个最新的版本吧，下载到你的电脑里，然后安装它。（安装教程参考：http://www.cnblogs.com/shiy/p/6441552.html）

7，接着，你在你的磁盘里的一个合适位置建立一个目录，专门用来存放开源代码，比如我在我的D盘下建立了一个git文件夹，进入git文件夹。

![Image 1][]

8，单击你的鼠标右键，会出现一个Git Bash 命令选项，单击进入。此时你看到的是一个命名窗口。

![Image 1][]

9，直接输入命令 git  clone  接着将起先的地址复制到后面，回车，就开始将你的github上的jvalidator的源码下载到你的电脑里了。

10，此时，就可以去开发里面的代码了，添加新的功能，修改明显的bug......这里就是你在参与开源开发了。

11，通过10后，保存好文件，回到我们的git bash命令界面，输入命令。

cd  jvalidator  //进入到这个文件夹。

git add .    //将改动的地方添加到版本管理器。

git  commit -m "some changes"  //提交到本地的版本控制库里，引号里面是你对本次提交的说明信息。

git push -u origin master  //将你本地的仓库提交到你的github账号里，此时需要你输入你的github的账号和密码，你输入就是了。

![Image 1][]

12，此时你在你的本的任务就完成了，进入到你的github上面，选择到这个jvalidator项目名，单击进入，右侧有个pull request，单击。

![Image 1][]

13，进入跳转的页面单击右侧的New pull Request按钮。

![Image 1][]

14，此时，你就能看到你改动的方了，核对下，没有问题后，就单击View pull request按钮

15，此时，你可以在页面中输入你的本次提交的说明信息，输入完后，单击提交按钮 comment

![Image 1][]

16,到此，你的任务就完成了，等到开源项目的管理人员审核，通过了，他就把你的改动合并到相应的开发分支上。

@**同步项目代码到本地**

在你帐户名下的项目主页面，有多种方式同步代码到本地。

直接下载源码的zip包【仅仅是代码下载不可同步】。

CloneinDesktop通过github的windows客户端同步到本地【windows下推荐此方式】。

使用ssh、https、sbuversion等协议同步到本地。

![Image 1][]

**@ 申请pull请求**

因为本地的代码是从你帐户下的fork分支同步下来的，所以提交的代码还是在你的帐户下；想要合并到项目的主分支并最终生效，就需要申请一个pull操作并等待项目创建者进行合并操作。

进入你帐户下项目的主页，点击pull requests。

![Image 1][]

正在上传...[取消][Link 1]

点击‘New pull request’。

![Image 1][]

正在上传...[取消][Link 1]

（此时可以查看到有变化的、等待提交合并的内容了；）

点击合并链接请求合并。

![Image 1][]

正在上传...[取消][Link 1]

提交成功后，整个过程就完毕了，以后的操作都是一样的。修改本地代码-》同步到hgithub-》申请pull请求；

剩下的就是项目创建者要做的事情了，如果他check提交的文件内容后，认为可以可并那么就会响应你的pull请求，如果觉得不可以合并就不会响应pull请求。只有在pull请求被响应后，你提交的代码修改内容才会同步到主项目中去。

**@ 提交修改代码**

即把本地代码同步到github上，根据下载同步的方式不同也有多种形式。

https、subversion形式的可以通过svn commit命令提交

CloneinDesktop形式的可以通过github的windows客户端提交

[https_github.com]: https://link.jianshu.com?t=https://github.com/
[Image 1]: 
[http_msysgit.github.io]: https://link.jianshu.com?t=http://msysgit.github.io/
[Link 1]: https://link.jianshu.com?t=javascript:void%280%29