GitHub的简易使用
GitHub的简易使用
hezh一、前言
一个代码托管平台，也是一个近乎什么资源都能找到的平台，还是一个计算机科学的 “基础设施” 之一，更是一个伟大开源社区，类似的平台有国内的 Gitee（码云）。
GitHub创造的 Pull Request（PR） 机制和 Issues 系统，已经成为开源协作的事实标准。它不仅仅是个代码仓库，更是一个全球开发者围绕项目进行协作、讨论和社交的庞大社区。
二、注册
（一）网络问题
难的不在于注册，其实更难的是网络问题，GitHub 服务器在境外（美国），国内没有专属直连线路，类似于有时候进不去微软官网一样。解决的方法有二：
-
直接使用魔法，最快也是最省事 - 使用 watt toolkit 软件（原名叫做 steam++ ，是一种 steam 单机玩家用来挂卡的软件），微软商店直接搜索安装即可
（二）注册
开小号演示。
- 官网：https://github.com
- 操作看图集
三、熟悉面板
（一）简要概括
首先，在GitHub来说，项目 = 仓库，这两个词的意思等价，本质上是一个大的文件夹，里面包含源代码和 README.md，就像我们在 Windows 桌面创建一个文件夹，里面放很多东西。
全部仓库（项目）都遵循这个 [ https://github.com/作者名字/项目名称 ] 模板，比如 [https://github.com/SunBK201/UA3F]，从这url可以看出 SunBK201 作者有个名为 UA3F 的项目。
（二）项目首页
元素太多，按上图的标注数字来逐个说明
[1] SunBK201 / UA3F
可以让我们知道现在哪个作者哪个仓库下。
[2] Code（代码）
主页面，罗列源文件，若点到别的地方，点击 Code 即可快速回到主页面。
[3] Issue（议题）
是用户向作者提出疑惑、修改建议、bug问题反馈以及bug修复建议等的地方（如下图），相当于app的反馈区。
[4] Fork（复刻）
每个人都可以完整的复制一份到你自己的仓库，可以二创，也可以是备份，怕作者哪天就删库了。删库指的是作者毫无征兆的把项目删除了。
[5] Star（星标）
相当于抖音的点赞/收藏，下拉点击 create list 可以创建多个合集，分门别类，相当于 dy 的收藏文件夹。这是一项最重要的指标，判断一个项目的受欢迎程度。
[6] About（概括）
字面意思，写明了本仓库的简要概括、用途、开源协议、成就…
[7] Releases（发布）
这个是最经常用得到的，若本仓库有安装包（apk、exe等等），作者一般放在 Release 区，点进去就可以下载。
可以看到这个 lyswhut 作者有两个关于音乐的项目，分别是手机端和桌面端的。
点进来发现有个很大的数字，那是版本号，作者迭代了很多版本，越在上面的版本就越新，如 2.12.1
我们下拉找到 Assets（资产），软件包就放在这里了！Windows 系统就选带x86.exe 字样的，但是我们这里好像没有 exe 文件？！请看下面的 Show all 27 assets，点击就会全部展示了，lx-music-desktop-v2.12.1-x64-Setup.exe 即为电脑的安装包文件，.dmg 是苹果电脑的。
手机（安卓）就选带 armv8.apk 字样的，现在手机CPU主流都是 arm 架构的，arm v7是老架构（32位的），是苹果5S的同时期产物，现在的新机无脑选 arm v8（64位）。
Tip
现在的版本号规范主流是 语义化版本，格式是：主版本号.次版本号.修订号，即 X.Y.Z
另外，还能见到诸如 -alpha、-beta、-rc，这些都表示不稳定版本。
- alpha：内部测试版，功能可能不完整。
- beta：公开测试版，Bug较多，不建议生产使用。
- rc：候选发布版，几乎不会有新功能，只做最后的Bug修复。
[8] Code（代码）
下载源码，相当于把整个仓库打包，就像Windows桌面打包了一个大文件夹，并压缩为zip格式。如下图，红框内的全部文件就会被你下载。
点击 Code 下拉可以选择两种下载方式：
-
直接 Download
下载的压缩包的名字格式是 [项目名-分支名.zip] ，例如： -
克隆到本地
- 首先要下载 git 工具，官网：https://git-scm.com/install/windows
- 在你想存放的位置右键选择 Open Git Bash here
- 复制克隆命令，回车
Tip
由于网络连通性问题，git clone 命令下载速度大概率很慢，参考：https://999314.xyz/posts/f4f1e204/
[9] README（使用说明）
其实就是 README.md 文件（.md是Markdown的意思，一种极其简单易学、轻量级标记语言，常用于写文档），把他单独放到一个大窗口来显示，是一个仓库非常重要的文件，有句话说得好，一个仓库可以没有源代码，但肯定有README.md文档！README就像是产品的说明书，详细说明了本项目如何使用、想法是什么、如何运作…
四、热门仓库
这里贴几个热门仓库:
- clash :https://github.com/clash-verge-rev/clash-verge-rev
- 《hello，算法》：https://github.com/krahets/hello-algo
- hello-agents：https://github.com/datawhalechina/hello-agents
- chrome-devtools：https://github.com/mcp/ChromeDevTools/chrome-devtools-mcp
- superpowers：https://github.com/obra/superpowers
- ccswitch：https://github.com/farion1231/cc-switch
五、结语
本文直接誊抄自私下写于2026-03-31的 word 文档，当时主要用于分享给其他学校的朋友，现在看来部分文字或思想可能错误！
