GitHub是一个Git的远程代码托管平台,它除了提供代码托管外,还提供了如问题发布、pull request、报表统计等功能,下图为EFCore项目的贡献者统计信息:
GitHub提供了一整套远程协作的解决方案,所以是开源项目的首选平台,许多知名项目都托管在GitHub上。
GitHub可以免费的创建自己的开源代码仓库,同时有付费服务,如私有仓库、GitHub的企业解决方案等。
GitHub中提供了个人仓库和组织仓库,分别适合个人开源项目以及组织开源项目。
个人仓库主页:
组织仓库首页:
创建组织:
填写组织信息:
仓库的创建与维护
1.创建一个仓库(个人和团队仓库创建类似,下图是团队仓库)
2. 仓库的维护:
针对每一个仓库,GitHub提供了代码管理(Code)、问题管理(Issues)、拉请求(Pull Request)、项目管理(Projects)、百科(Wiki)、统计(Insights)、仓库设置(Settings)功能,通过这些功能可以对代码仓库进行维护:
Fork与Pull request
Fork和Pull request是GitHub上完成代码共享的核心功能,下面就介绍如何使用Fork和Pull Request完成代码贡献:
1. 将贡献目标仓库Fork到自己的仓库中:
2. 获取Fork后的仓库,获取并对代码进行修改最后推送到远程分支(直接使用master分支):
修改代码后将修改的内容推到远程仓库:
注:更多使用Git的内容参考:《好代码是管出来的——使用Git来管理源代码》以及《好代码是管出来的——Git的分支工作流与Pull Request》。
3. 发起Pull Request:
创建新的pull request将会显示以下信息(代码由SelimTeam仓库合并到yqszt的仓库、代码是可合并的以及代码差异信息):
当点击“Create Pull Request”按钮后,该请求将会被创建。
4. 处理Pull Request:
yqszt/MyBlog库拥有者,可以在pull request选项卡中看到相应的信息并进行合并:
文件差异: