Github 基本概念
仓库(Repository):
仓库用来存放项目代码。你想在GitHub上开展一个项目,那必须新建一个Repository。每个项目对应一个仓库。如果你开展的项目多了,你就拥有多个 Repositorires。
收藏(Star):
仓库主页star按钮,意思为收藏项目,在GitHub上如果你有一个项目获得200个star都算很不容易了。
Star
复制克隆项目(Fork):
你有一个项目,别人很感兴趣想在你的基础上改进,应用到自己的项目中,这个时候他可以fork你的项目,将你的项目克隆(复制)到他自己的仓库中。该项目独立存在。不会因为别人的更改而改变项目本身。
例子:我复制了别人的仓库,我在自己的仓库里面做任何增删改查都不会改变原来的仓库
发起请求(Pull Request):
因为克隆复制的项目是独立存在的,如果别人做了改进,并且觉得应该和大家分享让更多人受益,于是将自己的项目pull request(简称:PR),发送给原作者,原作者review新代码,觉得OK的话就可以接受PR,这个时候项目就重新更新了。
关注(Watch):
关注项目,相当于社交网站的关注。如果你Watch了某个项目,那么以后只要这个项目有任何更新,你就会第一时间收到关于这个项目的通知提醒。
事务卡片(Issue):
发现代码Bug,给作者一个解决方案或者提醒。
GitHub主页: 浏览动态,关注用户,关注仓库动态
仓库主页:
显示项目信息:项目代码,版本,收藏/关注/fork情况等
个人主页:
头像,个人简介,关注的人,我关注的人,我的开源项目...
GibHub 注册
GitHub官网:
GitHub 已登陆时,进入个人首页,未登录时显示github首页(如图)
右上角:Sign in
登录 Sign up
注册
一步步填写信息就可:Username 用户名 Email address 电子邮箱 Password 密码
可能之后会选择免费或者付费仓库,选择免费即可。免费:所有人都可以访问无限。 付费仓库:自己或者规定朋友才可访问。
Create your account 注册GitHub
注册
登录
填写完成后,登录 (左边是仓库列表)
个人主页
注意:
- github在国外服务器,访问较慢,有些图片无法显示...
- 私有仓库需要付费,但是可以规定访问人群。
3.新用户注册后,必须验证邮箱才可创建git库仓库
GitHub 创建仓库
点击Start a project
: (创建仓库前需要验证邮箱!)
创建仓库
提示:可能不需要!GitHub验证邮箱收不到验证信息时尝试 QQ邮箱验证时可能需要设置白名单 (点击QQ邮箱左上角设置按钮,点击反垃圾,点击设置域名白名单添加github.com
邮箱设置
填写相关信息: Repository name
仓库名称 Description
描述 Initialize this repository with
: 创建一个描述文件(可以是REAME文件或者.gitignore或者其他license) 最后点击Create repository
创建仓库
Create repository创建仓库
新建仓库 test
仓库主页
注:
- 点击用户名可以回到用户主页
- 点击仓库名可以到仓库主页
- 点击文件名可以跳转到文件页面
Github 仓库使用
新建文件
点击 Create new file
添加加文件
Create new file
写文件名和编辑文件(这里可以是代码,可以是文本文件)
test / 文件名.文件格式(文件要带后缀)
Edit new file 是填写文件内容
Preview 是预览
在未来的项目中可以写一个描述,表明自己目的,方便所有人知道本次创建的原因或目的
格式:
Commit new file
提交标题
内容 点击 Commit new file
Commit new file
仓库信息中显示新文件了
commits
注:更新,增加都会增加提交次数
编辑文件
点击文件名
可以查看文件、删除文件、编辑文件
黄色区域: 从GitHub客户端打开文件,编辑文件,删除文件
文件在线编辑 点击右边的History
可以查看所有提交详情,点击文件描述也可以看到相似的结果
History 历史提交详情 点击编辑文件(小笔)界面与新建界面相同
最后的Commit new file改为 Commit changes 添加更新信息
Commit new changes 新的改变
点击文件描述
可以查看刚才填写的描述
文件描述
删除文件
删除文件,点击垃圾桶图标
删除文件会弹出删除描述,点击Commit changes
删除文件也是改变的一种方式
删除文件会跳转回仓库页面,会有删除文件提示,点击黄色标注区域可以查看删除详情
commits
commits详情
上传文件
点击 Upload files
点击 choose your files
选择本机文件(可以多个上传)进行上传,也可以用鼠标将文件拖动至此区域进行上传。文件上传后,填写描述(视情况而定)点击 Commit changes
查找仓库文件
当仓库中文件众多时,需要用查找方式找到目标文件
点击 Go to file
,也可以直接键盘按t
Go to file
输入文件名(部分文件名)即可
输入文件名 input file name
下载/检出文件
点击Code
可以选择用Git方式还是GitHub客户端打开方式,还是ZIP压缩包方式克隆下载项目
GitHub Issue
作用: 发现代码Bug,但是目前没有成型代码,需要讨论时用,或者使用开源项目讨论使用。
我这里就自己给自己发了
点击Issues
就可以发布Issue
Issues
这里显示所有Issues列表,点击 New issue
创建一个Issue
New issue
填写相关信息,里面可以像word一样编辑文本。填写完成后,点击 Submit new issue
发布
Submit new issue
发布后,会有显示
发布显示
当原项目作者点击左上角的GitHub图标进入自己的项目时,会显示Recent activity
得知有人改善了自己的项目。(我这里是自己给自己发)
Recent activity
点击activity
栏进入issue
,或者点击仓库名
进入到仓库主页,再点击issue
进入但是第二种可能分不清别人发的issue是发给哪个仓库的。
Recent activity
每个仓库都能查看自己仓库的Issues
My Issues
这里可以回复对方,点击Comment
回复对方,回复完毕后,问题解决后点击Close issue
可以关闭issue
。(双方都可以关闭issue
)
互相Comment
Closed Comment
可以在仓库的Issues
中看到Open
和Closed
的issues
列表
Issues 列表
Github 总结
页面相关操作总结
GitHub主页:
GitHub主页
仓库主页:
仓库主页
个人主页: 点击两个黄色区域可以进入个人主页
个人主页
这里显示(下图): 个人图像、用户名、加入时间、关注项目、关注用户,仓库等信息
个人图像、用户名、加入时间、关注项目、关注用户,仓库等信息
发起请求: 进入Pull request,点击New pull request
发起请求
如果有类似消息,点击Merge pull request
就可以合并项目,但是一定慎重考虑
合并项目
开源项目贡献
- 新建Issue:提交使用问题、建议或想法
Pull Request
:- 步骤1 fork项目;
- 步骤2 修改自己的项目代码;
- 步骤3 新建pull request;
- 步骤4 等待作者操作
转载至大佬 zhuanlan.zhihu.com/p/493499041 ,可以多点赞