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

构建代码库知识图谱解决方案-GitNexus 项目技术分析总结

构建代码库知识图谱解决方案-GitNexus 项目技术分析总结

GitNexus 项目技术分析总结 Building git for agent context. 为 AI 智能体构建代码库知识图谱的完整解决方案 一、项目概述 1.1 核心问题 GitNexus 解决的是 AI 代码助手(如 Cursor、Claude Code、Windsurf)缺乏对代码库深层结构理解 的问题。github地址:https://github.com/abhigyanpatwari/GitNexus 传统痛点: * AI 编辑代码时,无法感知依赖关系 * 修改一个函数,不知道 47 个函数依赖其返回值类型 * 导致破坏性变更被直接提交 GitNexus 的解决方案: 通过构建知识图谱(Knowledge Graph),将代码库的依赖、调用链、功能集群和执行流程全部索引,并通过

开源芯片的基石:RISC-V架构解析

开源芯片的基石:RISC-V架构解析

一、基本概念与起源 RISC-V(发音为"risk-five")是一种基于精简指令集计算(RISC)原则的开源指令集架构(ISA)。它由加州大学伯克利分校的研究团队于2010年启动,并于2011年首次公开发布。“V"在名称中有两层含义:一方面表示这是伯克利分校从RISC-I开始设计的第五代RISC架构,另一方面也代表了"变化”(Variation)和"向量"(Vectors)的双重扩展能力。 与传统闭源指令集不同,RISC-V的核心优势在于其开源特性。作为一项国际标准,RISC-V的规范完全开放,允许任何个人或组织自由使用、修改和扩展,而无需支付昂贵的专利费用或授权许可费。这一特性打破了由x86和ARM主导的芯片架构垄断局面,为全球半导体产业提供了新的技术路径。 RISC-V的开发团队由计算机体系结构领域的泰斗David Patterson教授领导,其团队在20世纪80年代已开发了四代RISC架构(RISC-I、RISC-II、SOAR和SPUR),这些早期探索为RISC-V的设计奠定了基础。与前四代相比,RISC-V摒弃了学术实验性质,转向实际应用,同时保持了开放、协作的设计理

20 万星开源神器 OpenClaw 全解析:程序员 + 视频博主双视角实战体验

20 万星开源神器 OpenClaw 全解析:程序员 + 视频博主双视角实战体验

2026 年初,AI 圈最大的黑马非OpenClaw莫属。这个从 Clawdbot、Moltbot 迭代而来的开源项目,在 GitHub 上星标狂飙至 21.7 万,成为现象级 AI Agent 框架。作为一名拥有 7 年大数据开发经验的程序员,同时也是正在转型视频剪辑的博主,我深度体验了这款工具近一个月,发现它不仅能解放开发者的双手,更能为内容创作带来革命性的效率提升。本文将从技术架构、核心功能、安装部署、双身份实战体验四个维度,带你全面解锁 OpenClaw 的奥秘。 一、核心定位与起源:从 “聊天 AI” 到 “能干活的数字员工” 1. 精准定义 一句话概括:OpenClaw 是本地可自托管、多渠道交互、具备强执行能力的开源 AI Agent 执行引擎。它打破了传统

【保姆级教程】SSH 远程连接 Gitee 码云仓库:从 0 到 1 手把手落地(避坑指南)

【保姆级教程】SSH 远程连接 Gitee 码云仓库:从 0 到 1 手把手落地(避坑指南)

在日常开发和学习中,我们经常需要与远程代码仓库交互,而SSH 连接方式相比 HTTPS,最大的优势就是无需每次推送 / 拉取代码都输入账号密码,既能提升效率,也能避免密码泄露的风险。 本文将以 Gitee(码云)为例,从账号准备、仓库创建,到 SSH 密钥生成、配置,再到最终的仓库克隆验证,全程详细拆解每一个步骤,哪怕是编程新手,也能跟着一步步操作成功,同时还会附上常见坑点排查,让你少走弯路! 一、前期准备 在开始操作前,先准备好以下工具和环境,避免中途卡顿: * 操作系统:本文以 Windows 10 为例(Linux/Mac 操作逻辑完全一致,仅终端操作略有差异) * 浏览器:Edge/Chrome(任意浏览器均可,用于访问 Gitee 官网) * SSH 工具:Xshell 8(