手把手教你如何加入到 GitHub 的开源世界

本文以提交一次开源代码为例，教会你步入开源的世界。

1. 注册账号与搜索项目

  1. 首先登陆到 https://github.com 平台上注册一个自己的账号，这个过程就不演示了。

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

    搜索开源项目

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

    选择项目

2. Fork 项目与克隆代码

  1. 此时，你已经进入到了 rinh/jvalidator 的项目主页了。单击右上角的 Fork 按钮，就把这个项目拉到你的账户下了，你就可以加入到这个项目中了。

    Fork 项目

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

    复制项目地址

  3. 你需要安装一个 Git 客户端工具。当然这类工具很多，我们演示就用它了：http://msysgit.github.io。到这个页面下载此工具，选择一个最新的版本下载到你的电脑里，然后安装它。

    下载 Git 工具

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

    建立目录

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

    打开 Git Bash

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

    克隆代码

3. 本地开发与提交

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

  2. 完成开发后，保存好文件，回到我们的 Git Bash 命令界面，输入以下命令：

    cd jvalidator             # 进入到这个文件夹
git add .                 # 将改动的地方添加到版本管理器
git commit -m "some changes"  # 提交到本地的版本控制库里，引号里面是你对本次提交的说明信息
git push -u origin master # 将你本地的仓库提交到你的 GitHub 账号里，此时需要你输入 GitHub 的账号和密码

    提交代码

4. 发起 Pull Request

  1. 此时你在本地的任务就完成了。进入到你的 GitHub 上面，选择到这个 jvalidator 项目名，单击进入，右侧有个 Pull Request，单击。

    进入项目页

  2. 进入跳转的页面，单击右侧的 New Pull Request 按钮。

    新建 Pull Request

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

    查看改动

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

    提交说明

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

说明：

  • 本文内容基于 2014 年左右的操作界面与工具版本编写。
  • 目前 GitHub 界面已有较大更新（如默认分支名可能为 main 而非 master，按钮位置有所调整），且 msysgit 已停止维护，建议下载官方最新版 Git（git-scm.com）。
  • 核心流程（Fork -> Clone -> Commit -> Push -> Pull Request）依然适用。

来自：http://www.cnblogs.com/wenber/p/3630921.html