Github全面学习笔记

简介: 不如看看官方的指导手册:https://guides.github.com/可以翻译成中文查看哦!====================================================如何创建分支branch?   分支可以方便同时处理多个版本的代码,它是在创建分支的那个时间点上的原始分支的精确副本。

不如看看官方的指导手册:https://guides.github.com/

可以翻译成中文查看哦!

====================================================
如何创建分支branch?
  分支可以方便同时处理多个版本的代码,它是在创建分支的那个时间点上的原始分支的精确副本。
  即可以随意的体验或者是更改、提交新的分支,直到准备好了就可以安全的和原始分支进行合并。
====================================================
如何创建Pull Request?
  Pull Request 用于提出对项目文件的更改,它是一个开始提交讨论的方式,它被经常用于代码审查中。
  如果是一个人工作的话,那么 Pull Request 可能没有太大的帮助,因为可以用学到的 git命令 来更改、推送到我们的主分支中,而不存在其他的分支。
  但是如果在公司项目或者是开源项目这种团队工作的情况下,会有很多分支。
  github 会知道你已经添加了更改到新的分支中,所以它会智能的建议你启动 Compare & pull request(比较和拉取请求)
====================================================
如何解决文件冲突?
  假设在合并 Pull Request 到我们的主分支之前,想对要合并的新分支添加修改,该如何做呢?
  答:只需到回到 windows 中对新分支中的文件进行修改再保存即可,之后打开 cmd控制台 进行 git命令 操作即可。

  演示在 github网站上 提交更改以及在本地计算机副本上提交更改来故意创建一个文件冲突。

  当我们刚开始使用 git 和 github 时,建议:不要在 github网站上 对文件做任何修改,而是在本地计算机副本上执行想要的修改和其他工作,
  这样做有助于我们有效地避免文件冲突。实际上,我们只是在本地计算机副本上进行更改且这个项目就是我一个人维护的话,那么我本地代码将永远和 github上 面的代码同步。

  但是呢,如果是在一个团队中和他人协作时,他人会在我工作的时候,向远程分支 push 的一个更改,而这个更改和我们正在本地计算机做的更改是同一个文件,那么就会导致文件冲突。
  这是一个相当普遍的问题。所以需要我们练习创建和修复冲突。
====================================================
如何创建组织?
  有时在团队协作中,当需要用到多个代码仓库时,就需要一个 github 的组织了。
  github 组织允许你管理和组织所有的代码仓库。一个 github 账户可以在不同的组织中工作。

  输入组织名和邮箱即可,暂时不选付费项目。其余的不用管,默认下一步就行。
====================================================
如何创建小组?
  比如:在谷歌工作,有开发小组、营销小组、运营小组,
  在我所在的开发小组里面有三个人,我们需要访问相同的代码仓库,并且经常需要互相交流。
  这个时候我们就需要单独的github小组,这样将有助于改善我们的工作流程。
  通常来说,在github中一个组织可以分为多个小组。小组允许我和组内的成员共享设置权限,不同的组有不同的权限分配。
  例如:开发小组有访问开发的权限,比如我有访问要开发软件的代码仓库的权限。
====================================================
如何在组织中创建代码仓库,并如何授予该组织中某个小组权限?
  比如:在 google 这样的组织中,代码仓库应该属于组织所有的。
  现在在组织中创建代码仓库,并且让开发小组能够访问到该组织新创建的代码仓库。
  给上次在该组织中创建的开发小组开放访问权限。
====================================================
如何在组织中的代码仓库里,为组织中的小组创建Pull Request(拉取请求/下载请求)?
  当你在一个更大的组织中工作时,良好的创建 Pull Request(拉取请求/下载请求) 的习惯是很重要的。
  许多组织使用 Pull Request 进行代码审查,当你对代码进行更改后,你可以邀请你的小组审核你所做的更改,并提供反馈。
  什么是好的 Pull Request 呢?
  当我们自己一个人工作时,Pull Request 只是帮助我们自己记住为什么修改,所以随意提交一个 Pull Request 都没关系。
  但是当我们作为更大团队的一部分,重要的是我们要清楚正在改变的是什么以及为什么要做出这样的改变。
  所以我们要填写下修改的标题和具体说明。
  使用组织的好处是:能够使用团队通知功能。
  现在使用一种简单的方法来确保该组织小组中的所有成员都能看到这个 Pull Request 
  @heizeTeam/developersteam
====================================================
什么是开源软件?
  开源软件是所有人都可以修改和补充的软件,因为开源软件的 licences 协议允许这样做。
  Git 版本控制系统就是开源的软件。
  实际上开源软件的一个重要组成部分就是添加 licences 文本文件,licences 告诉我们如何使用我们编写的代码。
====================================================
如何添加licences文件?
====================================================
如何找到一个优秀的且可以贡献的开源项目?
  法一:在 github网站 的主面板找到 Explore 选项卡 --> See more topics(查看更多主题) 或者 See more trending repositories(产看更多趋势库)
  法二:https://libraries.io/    寻找开源的包、框架和工具...
  注意:在我们使用开源项目之前,首先确定该开源项目的代码是公开的,可以查看它的 license 文件来了解这个开源项目允许使用的程度,其次是查看自述文件(READNE.md),了解该开源项目的状态。
====================================================
如何为开源项目提bug?
  大家都知道,在解决一个问题之前,必须先了解这个问题,所以创建一个 问题(Issues) 来帮助开源项目是一个很好的方式。
  当我们下载了开源项目的代码,引入到我的项目中,但是我们会发现这个代码中存在问题,并不能满足我的所有要求,可能是在我需要用到的一个函数里面有一个错误,但是我不知道如何修复这个错误,
  这个时候可以通过 github Issues 形式来构建一个非常好的问题报告来帮助项目的维护者和其他的贡献者来完善这个 bug ,从而来完善整个开源项目。

  演示:在我自己的代码仓库中的创建问题报告。

  首先要检查当前的问题列表中是否存在我要提交的问题,可以使用问题搜索框进行问题关键字搜索。
  注意:不要碰见一个问题就提交,这样对开源项目并没有好处。所以我们最好确保要为我们的开源项目创建一个真正有用的问题。
  我们最好把开源项目克隆到我的本地计算机中进行运行,进而发现问题。再到 github网站 上去 New issue
====================================================
如何Fork开源项目?
  实际上大多数的开源项目,都遵循着一个大致的工作流程。
  一个开源项目大致会有三种人:
    1.负责该项目,是该项目的所有者和维护者。(有pull和push权限)(修复bug)
    2.贡献代码,提出问题报告,是该项目的贡献者。(有pull无push权限)(提出bug修改意见)
    3.只是想使用该开源软件,是该项目的使用者。(无pull无psh权限)(发现bug)

  作为项目的贡献者,没有push权限,我们想要进行更改,怎么办呢?
  答:需要创建 ForkFork 可以获取当前代码仓库状态的一个副本。我们可以通过 Fork 将该项目移动到我们自己的账户或者所在的组织中。
  对于该副本我们拥有所有权限,可以进行 pull push 了。当我进行修改完成后,提交给项目的作者,在这两个代码仓库之间使用 Pull requests 
  如果作者认为我改的还可以,就会将这个 Pull requests 进行合并。
====================================================
如何在Fork到的开源项目中提交Pull requests?
  我们将 Fork 到的开源项目克隆到我们本地计算机中进行修改,把更改通过 Pull requests 到原始的项目中。

  此时开源项目的维护者就会看到这个 Pull requests 了,如果维护者觉得不错,就会 合并拉取的请求(Merge pull request)
  但是并不是所有的 Pull requests 都会被合并,这并不意味着你的修改是有问题的,有时候项目的维护者他就是不鸟你!你也没办法!
====================================================

我的GitHub地址: https://github.com/heizemingjun
我的博客园地址: http://www.cnblogs.com/chenmingjun
我的蚂蚁笔记博客地址: http://blog.leanote.com/chenmingjun
Copyright ©2018 黑泽明军
【转载文章务必保留出处和署名,谢谢!】
相关文章
|
1月前
|
编解码 Oracle Java
java9到java17的新特性学习--github新项目
本文宣布了一个名为"JavaLearnNote"的新GitHub项目,该项目旨在帮助Java开发者深入理解和掌握从Java 9到Java 17的每个版本的关键新特性,并通过实战演示、社区支持和持续更新来促进学习。
70 3
|
23天前
|
JSON JavaScript 前端开发
《进阶篇第7章》学习vue中的ajax之后,练习vue案例-github用户搜索案例
《进阶篇第7章》学习vue中的ajax之后,练习vue案例-github用户搜索案例
13 0
|
25天前
|
Unix Shell 网络安全
git学习六:(bug总结)git@github.com: Permission denied (publickey).等
本文是关于解决在使用Git和GitHub时遇到的“git@github.com: Permission denied (publickey)”错误的指南。文章提供了详细的步骤,包括确认SSH Agent运行状态、检查密钥配置、确保密钥匹配、验证仓库URL、检查权限和代理设置,以及配置SSH文件。这些步骤帮助用户诊断并解决SSH认证问题。
65 0
|
3月前
|
数据采集 数据可视化 Ruby
GitHub星标破万!Python学习教程(超详细),真的太强了!
Python 是一门初学者友好的编程语言,想要完全掌握它,你不必花上太多的时间和精力。 Python 的设计哲学之一就是简单易学,体现在两个方面: 1. 语法简洁明了:相对 Ruby 和 Perl,它的语法特性不多不少,大多数都很简单直接,不玩儿玄学。 2. 切入点很多:Python 可以让你可以做很多事情,科学计算和数据分析、爬虫、Web 网站、游戏、命令行实用工具等等等等,总有一个是你感兴趣并且愿意投入时间的。
|
5月前
|
Python
GitHub爆赞!终于有大佬把《Python学习手册》学习笔记分享出来了
这份笔记的目标是为了给出一份比较精炼,但是又要浅显易懂的Python教程。《Python学习手册》中文第四版虽然比较简单,但是措辞比较罗嗦,而且一个语法点往往散落在多个章节,不方便读者总结。 我在做笔记时,将一个知识点的内容都统筹在一个章节里面,因此提炼性大大提高。而且还有《Python学习手册》中文第四版的翻译在某些章节(可能难度较大?)措辞可能前后矛盾。当知识点提炼之后就能够很快的找到一些难以理解的概念的上下文,方便吃透这些难点。
GitHub爆赞!终于有大佬把《Python学习手册》学习笔记分享出来了
这份笔记的目标是为了给出一份比较精炼,但是又要浅显易懂的Python教程。《Python学习手册》中文第四版虽然比较简单,但是措辞比较罗嗦,而且一个语法点往往散落在多个章节,不方便读者总结。 我在做笔记时,将一个知识点的内容都统筹在一个章节里面,因此提炼性大大提高。而且还有《Python学习手册》中文第四版的翻译在某些章节(可能难度较大?)措辞可能前后矛盾。当知识点提炼之后就能够很快的找到一些难以理解的概念的上下文,方便吃透这些难点。
|
5月前
|
前端开发 Java C#
GitHub突破5k Star!这件事情我坚持了3年,努力打造C#/.NET/.NET Core全面的学习、工作、面试指南知识库
GitHub突破5k Star!这件事情我坚持了3年,努力打造C#/.NET/.NET Core全面的学习、工作、面试指南知识库
|
5月前
开始学习Github
开始学习Github
GitHub最新发布Java面试突击手册+P5-P8学习图谱,一夜直接竟爆火
什么是金九银十? “金九银十指的是每年的九十月份都是人才招聘的高峰期,因为跟春节和春运紧接,到人才市场,人都是满的,所以称为金九;伴随的十月则称为银十。”
|
6月前
|
安全 Shell 网络安全
Git学习---Git快速入门、Git基础使用、Git进阶使用、Git服务器使用(IDEA集成GitHub、Gitee、GitLab)、GitHub Desktop客户端
Git学习---Git快速入门、Git基础使用、Git进阶使用、Git服务器使用(IDEA集成GitHub、Gitee、GitLab)、GitHub Desktop客户端
195 0