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

Trae x Vizro:低代码构建专业数据可视化仪表板的高效方案

Trae x Vizro:低代码构建专业数据可视化仪表板的高效方案

声明:文章为本人真实测评博客,非广告,并没有推广该平台 ,为用户体验文章 目录 * 前言 * 一.核心工具与优势解析 * 低代码高效开发 * 专业视觉设计 * 高度灵活可定制 * AI赋能创新 * 二.操作步骤:从安装到生成效果 * 第一步. 获取MCP配置代码 * 第二步:下载 * 第三步:在 Trae 中导入 MCP 配置并建立连接 * 三. 实战:用Vizro MCP快速构建仪表板 * 1. 提出需求 * 2.智能体生成代码 * 3.查看运行结果 * 4.优化与部署 * 四.Vizro MCP核心功能解析 * get_vizro_chart_or_dashboard_plan * get_model_json_

By Ne0inhk

Neo4j 知识讲解与在线工具使用教程

图数据库领域的核心工具 ——Neo4j,同时详细拆解其在线预览控制台(https://console-preview.neo4j.io/)的使用方法,以及查询工具(https://console-preview.neo4j.io/tools/query)的模块功能。 一、Neo4j 核心知识铺垫 在使用工具前,我们需要先理解 Neo4j 的本质和核心概念,这是后续操作的基础。 1. 什么是 Neo4j? Neo4j 是世界上最流行的原生图数据库(Native Graph Database),专门用于存储、查询和分析 “实体之间的关联关系”。它与我们熟悉的 MySQL 等关系型数据库的核心差异的是: * 关系型数据库(MySQL):用 “表 + 行 + 外键” 间接表示关联,查询多表关联时需频繁 JOIN,效率低; * 图数据库(Neo4j)

By Ne0inhk
AI魔术师:基于视觉的增强现实特效

AI魔术师:基于视觉的增强现实特效

AI魔术师:基于视觉的增强现实特效 * 一、前言 * 二、AR 与视觉 AI 的技术基石 * 2.1 增强现实的核心概念 * 2.2 计算机视觉与 AI 的技术融合 * 2.3 技术栈选型与环境搭建 * 三、视觉 AR 的核心技术解析 * 3.1 相机标定与坐标系统 * 3.1.1 相机标定原理 * 3.1.2 标定代码实现 * 3.2 实时特征跟踪技术 * 3.2.1 ORB 特征跟踪原理 * 3.2.2 单目视觉里程计实现 * 3.3 语义分割与虚实融合

By Ne0inhk

BGE Reranker-v2-m3在地震预警系统中的落地:震感描述Query与应急响应流程匹配

BGE Reranker-v2-m3在地震预警系统中的落地:震感描述Query与应急响应流程匹配 1. 引言 想象一下这个场景:地震发生后,大量民众通过手机或网络平台上报自己的震感,信息五花八门——“房子晃得厉害”、“灯在摇”、“感觉床在动”。与此同时,应急指挥中心的后台系统里,躺着几十上百条标准化的应急响应流程文档。如何在海量、口语化的用户上报信息中,快速、准确地找到最匹配的官方处置流程,从而启动正确的应急响应?这不仅是效率问题,更是关乎生命财产安全的关键决策。 传统的关键词匹配或简单检索,在面对“晃得厉害”和“剧烈晃动”这类语义相近但表述不同的文本时,往往力不从心,容易漏掉或错配关键信息。今天,我们要介绍的就是一个能解决这个痛点的技术方案:基于 BGE Reranker-v2-m3 模型构建的本地文本重排序系统。它不生产知识,而是知识的“最佳调度员”——专门负责将用户的自然语言查询(Query),与一堆候选文本(如应急流程)进行深度语义匹配,并给出一个“谁更相关”的权威排序。 本文将带你深入一个具体的落地场景:地震预警系统中,利用BGE

By Ne0inhk