GitHub使用指南(保姆级教学)2025年12月15日版

GitHub使用指南(保姆级教学)2025年12月15日版

一、GitHub简介

GitHub是一项基于的服务,为软件开发Git版本控制提供Internet托管。这有助于开发人员存储和管理他们的代码,同时跟踪和控制对其代码的更改。

功能类别具体功能功能说明
代码托管与版本控制    仓库(Repository)管理支持创建公共和私有代码仓库,用于存储代码、文档等资源,免费版可满足无限协作者的私有仓库需求。
分支与合并管理    支持创建分支独立开发功能,可通过合并请求整合代码,还能设置分支保护规则,限制特定人员操作以保障代码安全。
提交历史追踪    完整记录代码的每一次修改,包括修改人、时间、内容,支持版本回滚,可随时恢复到历史稳定版本。
代码搜索与浏览支持按文件、目录、符号等维度在线搜索代码,界面直观,可快速定位和查看代码细节。
团队协作相关Pull Request(PR)开发者完成代码修改后提交合并请求,期间可开展多轮讨论,待审核通过后再合并至主分支。
代码评审支持在代码行级别添加评论,标注问题或建议,搭配 Code Owners 功能,确保关键代码变更经过对应负责人审核。
Issues 跟踪用于记录和管理任务、漏洞、需求等,可分配负责人、设置标签和里程碑,清晰跟踪问题解决进度。
组织与权限管理企业或团队可创建组织账号,统一管理多个项目;细分仓库所有者、管理员等角色,通过细粒度权限控制代码访问范围。
Discussions专属的非代码讨论区,可发起技术问题、项目规划等开放式交流,方便社区或团队集中沟通。

二、注册与登录

来到GitHub的主页(GitHub),然后Sign up注册一个账号。

输入邮箱,按照指引完成即可。

登录之后,来到了个人主页。

三、页面翻译

1.  使用浏览器自带的翻译功能

(推荐)

浏览器右上角输入框末尾自带翻译功能,点击翻译图标,点击“翻译”按钮。

2.使用浏览器插件

(不推荐,可跳过此小节,只了解用法)

点击浏览器右上角三个点——扩展——获取Microsoft Edge扩展。

搜索框输入:翻译。

搜索后,根据自己的喜好,点击“获取”插件。

点击“添加扩展”。

插件安装成功。

点击“查看扩展”。

点击浏览器右上角三个点——扩展——管理扩展。

确保插件能运行。

点击右上角扩展图标。

点击“有道灵动翻译”。

等待页面加载。

点击刷新网页。

页面加载成功。

点击翻译按钮,竟然没有效果。再次刷新网页,再翻译,仍然没有效果。

删除插件。点击浏览器右上角三个点——扩展——管理扩展——删除。

点击“删除”。

如果二维码有效则参与问题反馈。

我这边显示的二维码过期了很久。

所以推荐使用浏览器自带的翻译功能。

四、搜索资源

1.  普通搜索

屏幕右上角的这个搜索框,就是我们最常用的搜索功能。

打开搜索框快捷键:键盘按“/”。

鼠标带动光标点击搜索框,输入关键词:疯狂动物城。

搜索结果如下。

新概念:awesome list。精彩列表是由社区精心策划的精彩内容列表。这里有很棒的书单,涵盖从CLI应用奇幻书籍主仓库作为一个精心策划的精彩列表。

2.  精彩搜索

在GITHUB上搜索关键词的时候,在关键词前面加上awesome这个单词,是一种非常流行且高效的发现精彩资源的方法。

没有发现精彩资源也没事。

点击左上角的菜单,三个横杠。

点击:【Explore】,进入探索页面。

点击【Topics】,就能看到awesome list这个话题。

如果搜索:【awesome english】。

就能搜索到精彩的英语学习资源。

比如:

3.  高级搜索

高级筛选在左侧菜单栏,对结果进行高级过滤。想搜索仓库的名称,就选Repositories。想搜索仓库里的文件和代码内容,那就选Code。搜索用户、评论等等。

高级搜索功能。最常用的就是这个星标:【Number of stars】,相当于收藏夹。

点击:Number of stars,搜索框会自动弹出,可以选择范围值。

选择星标>1000。点击:Enter。

搜索出来的结果就是收藏次数大于1000的作品。

4.  高效搜索

5.  排序搜索

排序功能在右上角。可以按照最佳匹配、最多收藏等条件排序。

6.  他人主页搜索

在他人主页搜索的情况。在顶部的搜索栏输入项目名称,会自动出现两个按钮,一个是在当前作者的项目里搜索,另一个是在整个Github里搜索。

五、菜单

点击左上角三条杠图标,打开菜单栏。

点击Explore,进入探索页面。

Explore包含有意思的项目或者话题;

Topics主题里有热门话题;

Trending里有最近爆火的内容;

Collections   是精选列表。

Events里有大新闻。

推荐一个社区叫Hello Github,直接搜索:Hello Github,就能找到他们的资源库,他们每个月都会发布一期内容,总结当月的Github优质资源。

同时他们也有自己的网站叫:【hello github.com】,上面也是汇集了大量的优质Github资源,省得自己去寻找。

接下来就是另一个重点,也就是我们点进进入别人的代码仓库之后,应该如何使用。

首先要关注右上角,也就是星星这个位置,点击星星就是收藏这个项目。

方法一:

收藏了项目,可以点击右上角你的头像,然后选择【Stars】。

就可以看到你的收藏列表了。

方法二:

点击右上角你的头像,然后选择:【Repositories】。

再选择:【Stars】,就可以看到你的收藏列表了。

六、资源库页面使用方法

Fork是把项目复制一份到你自己的仓库。

Watch就是持续关注项目,有任何的更新都通知你。

右上角有一个绿色的按钮叫Code,点击按钮会弹出一个窗口,窗口最下面有一个Download Zip

,也就是下载项目的压缩包。

点击Download Zip就可以下载整个项目。

Download Zip这个方式一般用于资料库而不是项目,比如说我们搜出来的是英语的学习资料库,

里面都是一些学习文档,这个是直接可以Download Zip下载。

那如果这个库是一个开源项目,比如它是一个文本转语音的一个项目,我们就需要找到安装包。

这个时候一般有两种方式:

(1)一个是到项目的README说明书里找;

(2)那如果没有找到,就到页面右边的Release区域来找。

接下来,说一下项目的说明书。页面中间的文件列表,我们不需要关心,把窗口往下拉,就会看到一个说明书叫【README】,那大部分情况下项目的详细信息都会写在这里。

大部分情况下也会告诉我们怎么下载、怎么安装,或者有没有在线使用的一些demo等等。

有一些比较复杂的项目,它可能需要一些繁琐的部署步骤,而不仅仅是一个安装文件,那这个时候,就需要你详细的去阅读它的项目说明书了,你可以使用网页翻译工具给翻译成英文,如果你实在看不懂说明书,可以直接把内容复制出来发给AI。

有些AI还支持URL context功能,比如:Google的Gemini。

你可以直接把Github的URL和项目的说明书一起发给他,让他来帮你分析。

这里额外说一个问题,如果你在使用一个开源项目的过程中,遇到了一些问题或者bug,你想发送反馈给开发者,那么这个时候,你可以在这个项目页面的左上角。找到Issues这个选项,点击之后在页面上就可以新建一个Issues。

然后描述你的问题,点击New issue发送就可以发送给开发者。需要注意你使用的语言,如果开发者是外国人的话,就需要写英语了。

总结一下,就是要关注三个地方:第一、星标。第二、下载。第三、项目说明书。

七、创建自己的资源库

如果只是单纯的想创建一个自己的仓库。

方法一:

点击左上角三个横杠图标。

点击【Home】。

在你的Github个人主页左上角,点击New这个绿色的按钮,就可以创建一个自己的库了。

创建之后,可以点击Add file这个按钮来上传文件。

方法二:

在个人主页的右上角,点击:【+】,点击【New repository】新建仓库。

为仓库起个名字【Repository name*】,填写简介描述【Description】。选择权限【Choose visibility】、添加README文件【Add README】。

点击创建仓库【Create repository】。

八、上传并编辑文件

点击【Add file】,可以【Create new file】创建新的文件夹(在线编辑),也可以【Upload files】上传文件(本地编辑再上传)。

1.方法一

1.1创建新的文件夹

方法一,先点击【Create new file】创建新的文件夹。修改文件名。目前界面已处于 【Edit】 标签页,当前显示的 “Enter file contents here” 区域就是编辑区。

1.2编辑文件

直接在编辑区的输入框内输入你需要的内容(比如代码、文本等)。

写完可以按【Preview】预览。

右上角Cancel changes(灰色按钮),作用是放弃当前对文件的所有编辑内容,恢复到编辑前的状态,点击后不会对仓库产生任何修改。

Commit changes...(绿色按钮),用于提交已编辑的内容到仓库分支。点击后会进入提交详情页,需填写提交说明(描述本次修改),确认后即可完成修改的保存。

1.3提交文件

点击Commit changes...(绿色按钮)。

Commit message:用于简要描述本次提交的内容。

Extended description:选填项,可补充提交的详细说明(如修改背景、细节等)。

Commit directly to the main branch:直接将修改提交到main主分支,适用于个人仓库或无需审核的快速修改。

Create a new branch...:创建新分支并发起拉取请求(Pull Request),适用于团队协作场景(需审核后合并到主分支)。

全部填/选完成后,点击Commit changes(绿色按钮)。

1.4修改文件

修改文件。点击Test_file。

最右边,点击铅笔图标。

即可修改。

点击Commit changes(绿色按钮)。

Commit message:已自动填写 “Update Test_file with additional content”,清晰描述了本次操作是 “为 Test_file 添加额外内容”。

Extended description:选填项,可补充修改细节(如具体添加的内容、修改原因等)。

已选中 “Commit directly to the main branch”:将修改直接合并到主分支,适合个人仓库或无需审核的场景。

若选择 “Create a new branch...”:会创建新分支并发起拉取请求,适用于团队协作中的代码审核流程。

确认信息无误后,点击绿色的 “Commit changes” 按钮即可完成提交;点击 “Cancel” 则放弃本次修改。

点击绿色的 “Commit changes” 按钮。

标签页:包含 “Code”(当前显示代码内容)和 “Blame”(用于查看每行代码的提交者、提交时间等溯源信息)。

文件信息:显示文件共 2 行(2 个代码行)、41 字节大小。

点击:【Blame】。

右边弹窗提示:“可自定义行高(Customizable line height)”。

Enable compact line height:点击可启用紧凑行高,让代码显示更密集。

Dismiss:关闭该提示弹窗,保留当前行高设置。

点击:【Enable compact line height】。

状态:1 个文件(Test_file)发生变更,包含 “+2” 行新增内容、“-1” 行删除内容。
内容变化:删除了原第 1 行的 “- 测试文本”,新增了 “测试文本。”(第 1 行)和 “这是修改的内容。”(第 2 行),绿色区域代表新增内容,红色区域代表删除内容。

Comments:支持对变更内容添加评论,用于协作中的代码审核或讨论。
Subscribe:可订阅该变更线程的通知,及时获取后续互动信息。

2.方法二

2.1上传文件

方法二,点击【Upload files】上传文件(本地编辑再上传)。

支持将文件拖拽至 “Drag files here to add them to your repository” 区域完成上传;
也可点击 “Or choose your files” 手动选择本地文件上传。

Commit message:默认内容为 “Add files via upload”,用于说明本次操作是 “通过上传添加文件”,可根据实际需求自定义修改,以便清晰记录提交意图。

Extended description:选填区域,可补充本次文件上传的详细背景(如文件用途、修改说明等)。

Commit directly to the main branch:已选中,代表将上传的文件直接提交到仓库的main主分支,适用于个人仓库或无需审核的快速更新场景。

Create a new branch...:可选策略,会创建新分支并发起拉取请求(Pull Request),适用于团队协作中需要代码审核后再合并的场景。

选择自己想上传的文件。

点击绿色的 “Commit changes” 按钮。

这样就上传成功了。

2.2修改文件

修改文件。依旧可以点击文件,点击1.txt。

点击右边的铅笔图标。

接下来步骤和之前的在线编辑一样。

Read more

收藏必备!9个GitHub热门开源智能体项目:从小白到高手的完整进阶指南

收藏必备!9个GitHub热门开源智能体项目:从小白到高手的完整进阶指南

本文精选9个GitHub热门开源AI智能体项目,涵盖从入门级到专业级应用,包括AutoGPT、MetaGPT、LangChain等。这些项目能帮助读者从零开始构建自己的AI助手,无需从零造轮子,快速实现场景落地。无论你是想体验智能体还是将其融入工作流,这份清单都能提供从小白到进阶的完整学习路径,助你高效解决实际问题,提升工作效率。 智能体到底值不值得学? 如果用一句大白话来解释,智能体就是“一个能自己干活的AI助手”。你给它一个目标,它会自己拆解任务、调用工具、调整策略,甚至可以和其他智能体组队“开工”。 对我这种习惯边学边试的产品经理来说,智能体最吸引人的地方有两个: * 不用从零造轮子:开源项目直接 clone 下来,改改配置就能用。 * 场景落地快:从写日报、整理资料到模拟团队协作,都能很快跑起来。 所以说,如果你只是想体验智能体,随便玩玩之前我推荐的国产智能体就够了;但如果你真想让 AI 融入工作流,那下面这 9 个项目,基本能覆盖从小白到进阶开发的所有阶段。 我推荐的9个开源智能体项目 下面大部分我都简单试过,但不完全,今天先整理出来给大家 1. Au

By Ne0inhk
Linux系统学习【深入剖析Git的原理和使用(下)】

Linux系统学习【深入剖析Git的原理和使用(下)】

🔥承渊政道:个人主页 ❄️个人专栏: 《C语言基础语法知识》《数据结构与算法》 《C++知识内容》《Linux系统知识》 ✨逆境不吐心中苦,顺境不忘来时路!🎬 博主简介: 引言:在深入剖析Git的原理和使用(上)中,我们已经搭建起Git的基础认知框架—从Git的诞生背景、核心设计理念出发,掌握了初始化仓库、提交版本、查看日志、简单分支创建与切换等基础操作,也初步触及了Git“分布式版本控制”的核心优势.但这些表层操作,仅仅是Git强大功能的冰山一角:当我们面对多人协作中的代码冲突、复杂分支的合并与管理、误操作后的版本回滚难题,或是想弄明白“Git如何高效存储版本数据”“远程仓库与本地仓库的同步逻辑是什么”时,仅靠基础操作往往无从下手,背后的核心原理才是解决这些问题的关键.本篇将聚焦远程仓库的进阶协作(拉取、推送、复刻、协同开发流程).将坚持“原理+实操”结合的思路,真正发挥Git在版本控制、团队协作中的核心价值,为后续的高效开发、规模化协作筑牢基础.接下来,

By Ne0inhk

RAG系列:2025年最强开源RAG横评

RAG(Retrieval-Augmented Generation,检索增强生成)技术的出现,彻底改变了我们与AI交互的方式。简单来说,就是让AI不仅能"思考",还能"查资料"。想象一下,一个既有ChatGPT的推理能力,又能随时查阅你的专业资料库的AI助手,这不就是我们梦寐以求的"AI大脑外挂"吗? 本文真正从实战角度去深度评测这些平台。用30天时间,5个平台,真刀真枪地测一遍。 📊 评测维度:怎么"折腾"这些平台的 在正式开始之前,先说说我的评测方法。很多技术评测只看功能列表,我觉得这样不够实际。真正的好产品,应该经得起实战考验。 核心评测维度 1. 部署难度(20分) * 环境要求复杂度 * 安装步骤繁琐程度 * 首次运行成功率 * 文档完整度 2. 功能完整度(25分)

By Ne0inhk
【STM32】项目实战——OV7725/OV2604摄像头颜色识别检测(开源)

【STM32】项目实战——OV7725/OV2604摄像头颜色识别检测(开源)

本篇文章分享关于如何使用STM32单片机对彩色摄像头(OV7725/OV2604)采集的图像数据进行分析处理,最后实现颜色的识别和检测。 目录 一、什么是颜色识别 1、图像采集识别的一些基本概念 1. 像素(Pixel) 2. 分辨率(Resolution) 3. 帧率(Frame Rate) 4. 颜色深度(Color Depth) 5. 图像处理(Image Processing) 6. 图像采集设备 7. 亮度(Luminance)与色度(Chrominance) 8. 图像编码与压缩(Image Encoding and Compression) 9. 图像识别(Image Recognition) 10. 图像采集与处理中的延迟(Latency) 二、OV7725简介

By Ne0inhk