GitHub
什么是GitHub?
GitHub是一个基于Git的代码托管平台,核心功能是「代码存储、版本控制、团队协作」,同时也是全球最大的开源社区,拥有海量开源项目(如Vue、React、Python官方库等),普通人可免费注册使用,用于管理个人项目、学习开源代码、参与团队开发。
补充:Git与GitHub的本质区别——Git是本地版本控制工具(管理电脑上的代码版本),GitHub是远程代码托管平台(将本地代码上传到云端,方便共享和协作)。
账号注册
访问GitHub官网:https://github.com/ ,点击右上角「Sign up」;
填写注册信息:用户名(建议英文+数字,避免特殊符号,将作为个人主页地址)、邮箱(用于验证和接收通知)、密码(建议复杂且牢记);
完成验证:根据提示完成人机验证(如拖动滑块、选择图片);
邮箱验证:登录注册邮箱,点击GitHub发送的验证链接,完成账号激活;
后续引导:激活后,GitHub会引导选择兴趣领域、编程技能,可跳过(后续可在设置中修改),完成注册。
注意事项:用户名一旦确定,后续修改会影响个人主页地址和仓库链接,建议谨慎选择;邮箱建议使用常用邮箱,避免丢失账号。
个人账号基础设置
登录GitHub后,点击右上角头像,选择「Settings」(设置);
个人信息设置(Profile):上传头像(建议清晰的个人头像,提升辨识度)、填写姓名、个人简介(可填写个人技能、联系方式、开源方向)、设置个人主页地址(默认是github.com/用户名);
安全设置(Security):开启双重验证(Two-factor authentication),提升账号安全性(推荐,步骤:Settings → Security → Two-factor authentication → Enable);
邮箱设置(Emails):确认注册邮箱已验证,可添加备用邮箱,设置通知邮箱偏好。
拓展:可根据需求设置个性化主题(Settings → Appearance → Theme),切换浅色/深色模式。
仓库(Repository)
什么是仓库?
仓库是GitHub中存储项目的核心容器,相当于一个「云端文件夹」,可存储代码、文档、图片等各类文件,每个仓库对应一个独立的项目,支持版本控制、权限管理等功能。
分类:仓库分为「公开仓库(Public)」和「私有仓库(Private)」——公开仓库可被所有GitHub用户查看、Fork(复刻),适合开源项目;私有仓库仅自己或授权用户可查看,适合个人项目、团队内部项目(免费账号可创建无限私有仓库)。
例如此教程就是托管在GitHub仓库里的,你可以点击右上角的八爪鱼图标查看。
创建仓库
登录GitHub后,点击右上角「+」,选择「New repository」(新建仓库);
填写仓库信息:
Repository name(仓库名称):建议简洁明了,与项目主题一致(如「my-first-project」「vue-demo」);
Description(描述):可选,填写项目简介(如「GitHub新手练习项目」「个人博客源码」);
Visibility(可见性):选择「Public」(公开)或「Private」(私有);
Initialize this repository with a README(初始化仓库时创建README文件):必选,README文件是项目的说明文档,用于介绍项目功能、使用方法等;
Add .gitignore(添加忽略文件):可选,选择对应语言(如Python、JavaScript),.gitignore文件用于指定无需上传到GitHub的文件(如临时文件、依赖包、IDE配置文件);
Add a license(添加许可证):可选,开源项目建议添加许可证(如MIT License),明确项目的使用权限。
点击「Create repository」,完成仓库创建,跳转至仓库主页。
仓库主页核心功能介绍
仓库主页是操作项目的核心界面,重点关注以下功能区:
Code(代码):查看仓库内的所有文件,可直接在线编辑、下载文件;
Issues(问题):用于提交bug、提出需求、讨论项目相关问题(团队协作、开源贡献常用);
Pull requests(PR):用于提交代码修改请求(如向开源项目贡献代码、团队内合并分支);
Actions(动作):用于自动化部署、测试项目(进阶功能,后续讲解);
Projects(项目):用于管理项目任务、进度(团队协作常用);
Wiki(维基):用于编写项目详细文档(如使用手册、开发文档);
Stars(星星):用于收藏仓库,方便后续查找,也是项目受欢迎程度的体现;
Fork(复刻):将他人的公开仓库复制到自己的账号下,可基于此进行修改、学习;
Clone(克隆):将仓库下载到本地电脑,方便本地编辑代码后上传。
仓库文件操作
上传文件
进入仓库主页,点击「Add file」,选择「Upload files」;
拖拽本地文件/文件夹到上传区域,或点击「choose your files」选择文件;
填写Commit changes(提交说明):简要描述上传的内容(如「上传项目首页HTML文件」「添加README文档」),必填;
点击「Commit changes」,完成文件上传,刷新页面即可看到上传的文件。
在线编辑文件
进入仓库主页,点击需要编辑的文件(如README.md);
点击文件右上角的「铅笔图标」(Edit this file),进入编辑界面;
编辑内容(如修改README的项目简介),编辑区支持Markdown格式(后续讲解Markdown基础);
填写Commit changes(提交说明),描述修改内容(如「修改README项目简介,补充使用方法」);
点击「Commit changes」,完成文件修改。
删除文件
进入仓库主页,点击需要删除的文件;
点击文件右上角的「垃圾桶图标」(Delete file);
填写Commit changes(提交说明),描述删除原因(如「删除无用的测试文件」);
点击「Commit changes」,完成文件删除。
注意事项:文件删除后可通过历史提交记录找回,后续会讲解如何查看历史版本。
版本控制
Commit(提交)
Commit是GitHub版本控制的核心,相当于「给当前的文件状态拍一张快照」,每次修改、上传、删除文件后,提交一次Commit,会记录下修改内容、修改人、修改时间,方便后续查看历史、回滚版本。
关键要点:每个Commit都有一个唯一的Commit ID(一串字母+数字的组合),用于定位具体的版本;提交说明(Commit message)要简洁明了,准确描述本次修改的内容,方便自己和他人查看。
查看历史提交记录(History)
进入仓库主页,点击「Commits」(位于仓库名称下方);
进入历史提交页面,可查看所有的Commit记录,包括提交时间、提交人、提交说明、Commit ID;
点击任意一条Commit记录,可查看本次提交的具体修改内容(新增内容标绿,删除内容标红);
若需要回滚到某个历史版本,点击该Commit记录的「Browse files」,即可查看该版本的所有文件,也可下载该版本的代码。
分支(Branch)
什么是分支?
分支相当于「项目的平行副本」,默认情况下,每个仓库只有一个主分支(main/master,GitHub目前默认是main),用于存储稳定的代码。我们可以创建新的分支,在新分支上进行修改、测试,修改完成后再合并到主分支,避免直接修改主分支的稳定代码,减少冲突。
应用场景:团队协作中,每个人在自己的分支上开发功能,开发完成后提交PR,合并到主分支;个人项目中,可创建分支测试新功能,避免影响主分支的正常运行。
创建分支
进入仓库主页,点击分支下拉框(默认显示main);
输入新分支的名称(建议简洁明了,与功能相关,如「feature/login」「fix/bug1」);
点击「Create branch: 分支名称」,完成分支创建,自动切换到新分支。
切换分支
进入仓库主页,点击分支下拉框,选择需要切换的分支,即可快速切换到对应分支,查看该分支的文件和提交记录。
合并分支(Merge)
当新分支的功能开发完成、测试通过后,需要将其合并到主分支(以「新分支合并到main分支」为例):
切换到main分支,点击「Pull requests」→「New pull request」;
在「base」下拉框选择要合并到的分支(main),在「compare」下拉框选择要合并的新分支;
查看分支对比,确认修改内容无误后,点击「Create pull request」;
填写PR标题和描述(说明合并的功能、修改内容),点击「Create pull request」;
若没有冲突,点击「Merge pull request」,再点击「Confirm merge」,完成分支合并;
合并完成后,可选择删除已合并的分支(点击「Delete branch」),避免分支过多杂乱。
注意事项:若两个分支修改了同一个文件的同一部分,会出现合并冲突,需要先解决冲突(后续进阶部分讲解冲突解决方法),再进行合并。
删除分支
方法一:合并分支后,直接点击「Delete branch」删除已合并的分支;
方法二:进入仓库主页,点击分支下拉框,选择「View all branches」,找到需要删除的分支,点击分支右侧的「垃圾桶图标」,确认删除即可。
Issues
什么是Issues?
Issues是GitHub的协作沟通工具,用于提交bug、提出功能需求、讨论项目问题、分配任务等,相当于「项目的问题跟踪系统」,每个Issues都有唯一的编号,可跟踪处理进度。
创建Issues
进入仓库主页,点击「Issues」→「New issue」;
选择Issues模板(若有,如Bug report、Feature request),若无则直接填写;
填写标题(简洁明了,如「登录功能出现bug,无法正常提交」);
填写内容(详细描述问题:如bug的复现步骤、预期效果、实际效果;需求的具体内容等),可添加图片、代码片段辅助说明;
可选:添加标签(Labels),如「bug」「enhancement」(功能增强)、「good first issue」(适合新手的问题);添加负责人(Assignees),分配任务给具体人员;
点击「Submit new issue」,完成创建。
Issues管理
回复Issues:进入某个Issues页面,在评论区输入回复内容,点击「Comment」即可;
关闭Issues:当问题解决、需求完成后,点击Issues页面的「Close issue」,可选择关闭原因;
重新打开Issues:若关闭后发现问题未解决,可点击「Reopen issue」,重新开启跟踪。
Pull Request(PR)
PR的核心用途
PR不仅用于团队内部的分支合并,也是参与开源项目的核心方式——当你Fork了他人的开源仓库,修改了代码(如修复bug、添加新功能)后,可通过PR向原仓库提交修改请求,原仓库维护者审核通过后,你的修改会被合并到原仓库,完成开源贡献。
向项目提交PR
Fork开源仓库:进入目标开源仓库主页,点击右上角「Fork」,将仓库复制到自己的账号下;
克隆自己账号下的仓库到本地(后续讲解Git命令行操作),或在线编辑仓库文件,完成修改(如修复bug);
提交Commit,记录修改内容;
进入自己账号下的该仓库,点击「Pull requests」→「New pull request」;
在「base repository」选择原开源仓库,「base」选择原仓库的主分支;在「head repository」选择自己账号下的仓库,「compare」选择自己修改的分支;
查看修改内容,确认无误后,填写PR标题和描述(详细说明修改的目的、内容,符合原仓库的贡献规范);
点击「Create pull request」,提交PR,等待原仓库维护者审核;
若审核有反馈,根据反馈修改代码,修改后会自动更新PR,直至审核通过,完成合并。
注意事项:提交PR前,建议先查看原开源仓库的「CONTRIBUTING.md」(贡献指南),了解贡献规范,避免PR被拒绝。
GitHub 加速
访问加速
可以使用各种镜像站,比如https://bgithub.xyz、https://kkgithub.com 等。
警告
请不要在镜像站无法注册或登录账号、无法进行仓库管理。
下载加速
https://github.akams.cn/ 收集了大量加速网站。
代理加速
- 使用Watt Toolkit进行本地反代加速。
- 使用梯子。