听说过 GitHub 但完全不知道它是干嘛的?别慌,这份指南就是为你准备的。 我们不堆术语,用最直白的话讲清楚:GitHub 是什么、能干什么、怎么一步步用起来。
一句话:GitHub 是全球程序员放代码、管代码、一起写代码的平台,堪称"程序员的社交网络 + 云端仓库"。上面托管着超过 4 亿个项目,包括很多你每天都在用的软件。
一个工具软件(先有它)
一个网站平台(后诞生)
这些词你会在 GitHub 的每个角落看到。先混个眼熟,不用背,用到时回来查就行。
Repository / Repo一个仓库 = 一个项目的全部家当:代码、文档、修改历史都装在里面。可以是公开的(全世界的眼睛都能看),也可以是私有的(只有你自己和受邀的人能看)。
Commit每完成一小步改动,就做一次 Commit,并写一句说明(比如"修好了登录报错")。它像快照一样被永久记录,以后随时能回到任何一次存档的状态,再也不怕"改崩了回不去"。
Branch默认主线叫 main。想大胆尝试新功能又怕搞坏主线?开一个分支(如 feature-login),在"平行世界"里随便折腾,稳了再合回去。就像写作业先打草稿,满意再誊到正式本上。
Pull Request / PR你在分支上改完,就发起一个 PR:"我改了这些,请审核,没问题就合并进主线吧。" 项目维护者会逐行看你的改动、提意见,这是开源世界合作的核心方式。
ForkFork 会把别人的仓库原样复制一份到你的账号下,你可以随便改而不影响原项目。改好了想"回馈原版",就通过 PR 提交回去——这就是给开源项目贡献代码的路径。
CloneClone 是把 GitHub 上的仓库完整下载到本地(包含全部修改历史)。下载后你可以离线编辑,改完再"推(push)"回 GitHub 同步。小白阶段用网页版可以暂时不碰它。
Star觉得某个项目不错就点 Star:既是"赞",也会把它收进你的 Star 列表方便以后找。Star 数是项目人气的直观体现,你也会经常看到"给个 Star 再走吧"。
Issue发现软件有 Bug?想提新功能建议?就在仓库里开一个 Issue。它也是开发团队的任务管理板:每个问题一个编号(#123),解决后关闭。不会写代码也能在这里帮上忙。
README打开任何仓库首先看到的就是 README,它介绍这个项目是什么、怎么安装使用。写好 README 是新手的第一个练手任务——它用 Markdown 语法书写,比 Word 简单得多。
MergePR 审核通过后,分支上的改动就"合并"进主分支,成为正式版本的一部分。如果两拨人改了同一处产生冲突(Conflict),GitHub 会提示你手动选择保留哪边。
不用一次全学会。标 🟢 的是新手第一天就会用到的;🔵🟣 进阶后再解锁。
你的"代码朋友圈"头像页:展示项目、贡献记录(绿色小方格热力图)、Star 过的作品。
🟢 新手必备核心功能。免费创建不限量的公开/私有仓库,放代码、文档、作业、甚至小说。
🟢 新手必备"热门榜单":看看今天全世界最火的项目是什么,找灵感、找学习资源的好地方。
🟢 新手必备报告 Bug、提建议、参与讨论。很多开源项目靠 Issue 区组织协作和答疑。
🟢 新手必备免费网站托管!把网页代码放进仓库,一键获得一个 xxx.github.io 网址,做个人主页神器。
开源协作流水线:复制别人的项目 → 改进 → 提交合并申请 → 你的名字进入贡献者名单。
🔵 稍进阶自动化机器人:代码一提交就自动"测试、打包、发布"。相当于雇了个不知疲倦的流水线工人。
🟣 进阶玩法AI 编程助手:根据注释和上下文自动补全代码。学生认证后可免费使用。
🟣 进阶玩法轻量代码片段分享:不想建整个仓库,只想分享一小段代码/笔记时用它。
🟣 进阶玩法内置的"看板式"任务管理(类似 Trello),用表格/卡片安排项目进度。
🟣 进阶玩法仓库自带的论坛,适合问答、公告、长篇讨论,比 Issue 更"聊天化"。
🟣 进阶玩法云端编程环境:打开浏览器就是一个装好工具的开发环境,低配电脑也能写代码。
🟣 进阶玩法前 7 步只用浏览器,不需要装任何软件、不需要会写代码。跟着做,约 20 分钟完成。
打开 github.com,点右上角 Sign up,依次填:邮箱 → 设置密码 → 起用户名 → 邮箱验证码。
登录后看到的就是控制台。现在只需要认识三个地方:
点 New 按钮,按下面填:
hello-github进仓库后点 Add file → Upload files,随便拖一个文件进去(图片、txt 都行),然后:
上传我的第一张图片这就是一次完整的"存档"。文件列表里现在能看到它了。
点开 README.md → 右上角铅笔图标 ✏️ 进入编辑,试着写:
# 一级标题(这是最大的标题) ## 二级标题 普通文字直接写,**加粗**用两个星号,*斜体*用一个星号。 - 减号加空格 = 列表 - 列表第二行 [点我去看GitHub](https://github.com) ← 中括号是文字,圆括号是链接
点 Preview 标签可实时预览效果,最后 Commit 保存。Markdown 是写文档的通用语言,5 分钟就能上手。
用自己的仓库也能演练一遍专业协作流程:
my-first-branch → 点 Create branchmain 分支——你的改动已经"转正"了!去 github.com/trending 逛逛热门项目:
当你需要在本地写代码时,再学这一步:安装 Git(git-scm.com)或图形化工具 GitHub Desktop,然后克隆仓库:
git clone https://github.com/用户名/hello-github.git # 把云端仓库下载到本地 git status # 看看当前改了什么 git add . # 把改动放进"待存档清单" git commit -m "写清楚这次改了啥" # 存档(本地) git push # 把存档推送到 GitHub 云端 git pull # 把云端最新版本拉回本地
以后看教程、看别人讨论时卡在某个词上,回来这里查。
| 术语 | 中文 | 一句话解释 |
|---|---|---|
| Repository (Repo) | 仓库 | 一个项目的完整文件夹,包含所有文件和修改历史 |
| Commit | 提交 | 一次带说明的"存档",记录改动快照 |
| Branch | 分支 | 主线的"平行草稿世界",改稳了再合并回去 |
| main | 主分支 | 仓库默认的主线分支(以前叫 master) |
| Merge | 合并 | 把分支上的改动并入主分支 |
| Conflict | 冲突 | 两拨人改了同一处,需要人工决定保留哪个 |
| Fork | 复刻 | 把别人的仓库复制一份到自己账号下 |
| Clone | 克隆 | 把云端仓库完整下载到本地电脑 |
| Push | 推送 | 把本地的提交上传到 GitHub |
| Pull | 拉取 | 把 GitHub 上的最新改动下载到本地 |
| Pull Request (PR) | 拉取请求 | "请审核并合并我的改动"的正式申请 |
| Issue | 议题 | 项目的问题/建议/任务追踪帖 |
| Star | 星标 | 点赞+收藏,Star 数代表项目热度 |
| Watch | 关注 | 订阅仓库动态,有更新会通知你 |
| README | 自述文件 | 仓库的说明书/门面,用 Markdown 写 |
| Markdown (.md) | Markdown | 轻量标记语言,写文档用的"简易排版语法" |
| Git | Git | 本地版本管理工具,GitHub 的底层技术 |
| Profile | 个人主页 | 你的开发者名片,展示项目与贡献热力图 |
| Contributor | 贡献者 | 给项目提交过代码或文档的人 |
| License | 许可证 | 规定别人能怎么使用你代码的法律条款(如 MIT) |
| .gitignore | 忽略清单 | 声明哪些文件不纳入版本管理(如临时文件) |
| GitHub Pages | GitHub 页面 | 免费的静态网站托管服务 |
| GitHub Actions | 自动化 | 自动执行测试/构建/发布的机器人流水线 |
| Copilot | AI 助手 | GitHub 的 AI 代码补全工具 |
学完 8 步教程后,用这两个"真实战果"练手:一个永久免费的个人网站 + 写进开源项目贡献者名单的你。
学完手写流程,也该认识"AI 实习生"了。这三个主流的终端 AI 编程代理分别是什么、能干什么、怎么装怎么用、新手怎么选——已备好完整分区。
本站帮你入门,这些资源帮你进阶。全部免费。
有中文版!所有功能的权威说明,遇到具体问题先查这里。
docs.github.com/zh ↗官方互动练习课程,在真实仓库里边做边学 Git 和 GitHub。
skills.github.com ↗学生认证后免费解锁 Copilot、私有工具等一整套开发者福利。
education.github.com ↗官方图文指南合集:Hello World、Git 手册、Fork 工作流等经典入门文。
guides.github.com ↗半小时掌握写 README 必备的排版语法。
markdown.com.cn ↗10 分钟把你的仓库变成一个真正的网站。
pages.github.com ↗