GitHub 超详细新手使用教程（含实操代码）

写在前面：这篇文章适合谁？

如果你属于以下任意一种情况，这篇文章就是为你写的：

​‌‌​‌‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌​​​​‌​‌‌​‌‌​​​‌‌​‌​​​​‌‌​‌‌‌‌​‌‌‌​​‌‌​‌‌‌​‌​​​‌‌‌‌‌​​​‌‌​​​​‌​​‌‌‌​‌​​​‌‌​​‌‌​‌‌‌‌‌​​​‌‌‌​‌​​​​‌‌‌​‌​​‌‌​‌‌​‌​‌‌‌​​‌‌​‌‌‌​‌‌​​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌‌‌​‌‌​‌​​‌​​‌‌​‌​‌

• 听说 GitHub 很厉害，但完全不知道它是什么、能干什么
• 想把自己写的代码/项目保存到网上，但不知道怎么操作
• 想下载别人的开源项目来学习，但面对一堆英文按钮不知所措
• 已经注册了 GitHub 账号，但打开网站后一脸懵，不知道从哪下手
• 听说过 Git，但不清楚 Git 和 GitHub 到底有什么关系

别担心，这篇文章会用最通俗的语言，一步步带你从零开始，彻底搞懂 GitHub。不要求任何编程基础，只要你会上网、会用电脑，就一定能看懂。

第一章：先说清楚，GitHub 到底是什么？

一个比喻让你秒懂

想象你正在写一本小说。你每天写一点，改一点，突然有一天删了一段重要情节，想找回来却发现没有备份——崩溃。

这时候你灵机一动：不如把小说存到网盘上？每次写完就上传一次，网盘自动帮你保存所有历史版本，随时可以回退到任何一天的状态。而且，你还可以邀请朋友一起写，他写第一章你写第二章，互不干扰。

GitHub 就是为程序员打造的"超级网盘"——但它比网盘强大得多。它不仅能存代码，还能：

• 自动记录每一次修改（谁在什么时候改了什么，一清二楚）
• 随时回退到任意历史版本（删错了？一键恢复）
• 多人同时协作（你写你的，我写我的，最后合并到一起）
• 展示你的项目（把代码变成在线简历，面试加分利器）
• 发现全球开源项目（全世界的程序员都在上面分享代码，你可以免费学习、使用）

Git 和 GitHub 不是一回事

这是新手最容易混淆的概念，一句话说清楚：

Git 是一个工具，安装在你的电脑上，负责在本地管理代码版本。
GitHub 是一个网站，用来把 Git 管理好的代码存到云端，方便分享和协作。

打个比方：Git 是 Word 软件（本地的编辑器），GitHub 是百度网盘（云端的存储空间）。你把写好的文档用 Word 编辑好，然后上传到百度网盘分享给别人——Git 和 GitHub 就是这个关系。

使用 GitHub 不一定要用 Git 命令行，GitHub 官方出了一个叫 GitHub Desktop 的桌面软件，点几下鼠标就能完成所有操作，对新手非常友好。不过本文还是会从命令行讲起，因为学会命令行之后，你会发现它其实比图形界面更简单、更快。

第二章：注册账号 & 安装 Git

2.1 注册 GitHub 账号

打开 github.com，点击右上角的 Sign up。

填写以下信息：

• 邮箱：建议用常用邮箱（QQ邮箱、163邮箱都可以），之后会用这个邮箱配置 Git
• 密码：至少 8 位，包含字母和数字
• 用户名（Username）：这是你的 GitHub ID，会出现在你的仓库地址里，比如 github.com/你的用户名

用户名建议想好再填，虽然可以改，但改了之后仓库地址会变。尽量用英文+数字，不要太长，看起来专业一些。比如你的英文名 + 姓，或者一个有辨识度的昵称。

注册完成后，GitHub 会给你注册邮箱发一封验证邮件，记得去邮箱里点一下验证链接，否则有些功能会受限。

2.2 安装 Git

打开 git-scm.com/downloads，根据你的操作系统下载对应版本：

• Windows：下载 .exe 安装包，双击安装，一路点 Next 就行（所有选项保持默认即可）
• macOS：下载 .dmg 安装包，或者直接在终端输入 git --version，系统会提示你安装 Xcode Command Line Tools，点"安装"就行
• Linux：在终端输入 sudo apt install git（Ubuntu/Debian）或 sudo yum install git（CentOS）

安装完成后，验证一下是否安装成功。打开终端（Windows 用户打开 Git Bash，macOS/Linux 用户打开终端），输入：

git --version

如果看到类似 git version 2.42.0 的输出，说明安装成功了。

第三章：配置 Git（这辈子只做一次）

安装完 Git 之后，需要告诉 Git "你是谁"。因为每次提交代码，Git 都会记录是谁提交的，这个信息会永久保存在提交历史中。

打开终端（Windows 用户打开 Git Bash），输入以下两行命令（把引号里的内容替换成你自己的）：

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

举个例子，如果你的 GitHub 用户名是 zhangsan，邮箱是 zhangsan@gmail.com，那就输入：

git config --global user.name "zhangsan"
git config --global user.email "zhangsan@gmail.com"

配置完成后可以用以下命令检查：

git config --global user.name
git config --global user.email

如果输出你刚才填的内容，说明配置成功。这两行命令一辈子只需要执行一次，除非你换电脑或换账号。

第四章：创建你的第一个仓库

4.1 什么是仓库（Repository）？

仓库（Repository，简称 repo）就是 GitHub 上的一个"项目文件夹"。一个仓库通常对应一个项目，里面包含这个项目的所有代码、文档、图片等文件。

你的 GitHub 账号下可以有无数个仓库，每个仓库都是独立的。

4.2 在 GitHub 网页上创建仓库

1. 登录 GitHub，点击右上角的 + 号，选择 New repository
2. 在 Repository name 输入仓库名，比如 my-first-project（只能用英文、数字、连字符和下划线）
3. Description 是描述，选填，写一句话介绍这个项目是干什么的
4. 选择 Public（公开，所有人可见）或 Private（私有，只有你自己可见）
5. 勾选 Add a README file（自动创建一个说明文档，建议勾选）
6. 点击 Create repository，仓库就创建好了

现在你看到的是一个空仓库，里面只有一个 README.md 文件。接下来，我们把这个仓库下载到本地，开始往里面添加代码。

4.3 把仓库克隆到本地

"克隆"（Clone）就是把 GitHub 上的仓库复制一份到你的电脑上。在仓库页面，点击绿色的 Code 按钮，复制那个以 https:// 开头的地址。

然后在终端输入：

git clone https://github.com/你的用户名/my-first-project.git

这条命令会在当前目录下创建一个名为 my-first-project 的文件夹，里面就是你的仓库内容。

进入这个文件夹：

cd my-first-project

现在，你就可以在这个文件夹里创建代码文件、修改文件了。所有改动都会被 Git 追踪到。

第五章：日常操作 —— 记住这四步就够了

这是 GitHub 最核心的操作流程，90% 的时间你只需要重复这四步：

第一步：查看当前状态

git status

这条命令会告诉你：哪些文件被修改了？哪些文件是新创建的？哪些文件还没被 Git 追踪？

建议每次操作前都先运行 git status，养成习惯后能避免很多错误。

第二步：把文件加入暂存区

git add .

Git 的设计比较特殊，修改完文件后不能直接提交，需要先把文件"加入暂存区"（Staging Area）。你可以把它理解为"购物车"——把想提交的文件放进购物车，然后一起结账。

• git add . 表示把当前目录下所有修改过的文件都加入暂存区
• git add 文件名 表示只加入指定的文件

第三步：提交（Commit）

git commit -m "描述你这次做了什么修改"

提交就是把暂存区里的文件"打包"成一个版本记录，永久保存在 Git 的历史中。-m 后面的引号里写提交信息，用来描述你这次改了什么。

写好提交信息是个好习惯，未来你回头看提交历史时，能快速理解每次修改的目的。比如：

• 好的提交信息：修复了登录页面在移动端的布局错乱问题
• 不好的提交信息：改了一下、update、fix

第四步：推送到 GitHub

git push

把你本地的提交记录"推送"到 GitHub 云端。执行完这一步，你的代码就出现在 GitHub 网站上了，别人也能看到你的最新改动。

补充：拉取最新代码

git pull

如果你在多个设备上写代码，或者和别人协作，每次开始工作前先执行 git pull，把云端最新的代码拉到本地，避免冲突。

完整的日常流程就是：

git pull          # 拉取最新代码（协作时必做）
# ... 写代码、改代码 ...
git status        # 看看改了什么
git add .         # 加入暂存区
git commit -m "修复了xxx问题"  # 提交
git push          # 推到云端

第六章：分支 —— 平行宇宙的玩法

6.1 什么是分支？

分支（Branch）是 Git 最强大的功能之一。想象你要给项目加一个大功能，但你不确定能不能做出来，也不想把正在写的半成品代码搞乱主项目——这时候就可以创建一个"分支"，在分支里随便折腾，成功了就合并回主分支，失败了直接删掉分支，主分支毫发无伤。

默认的分支叫 main（以前叫 master），这就是你的主分支，通常存放稳定版本的代码。

6.2 创建和切换分支

# 创建一个新分支
git branch feature-login

# 切换到新分支
git checkout feature-login

# 或者一条命令搞定：创建并切换
git checkout -b feature-login

现在你就在 feature-login 分支上了，可以放心地改代码、提交，这些操作完全不会影响 main 分支。

6.3 合并分支

当你在这个分支上完成了功能开发，想把它合并回 main 分支：

# 先切回 main 分支
git checkout main

# 把 feature-login 分支的改动合并进来
git merge feature-login

# 合并成功后，可以把 feature-login 分支删掉
git branch -d feature-login

6.4 冲突怎么办？

合并时如果两个分支修改了同一个文件的同一行，Git 不知道用哪个版本，就会产生"冲突"（Conflict）。

不用慌，Git 会在冲突的文件里标记出两个版本的区别：

<<<<<<< HEAD
这是 main 分支的版本
=======
这是 feature-login 分支的版本
>>>>>>> feature-login

你只需要手动编辑这个文件，保留你想要的内容，删除那些标记符号（<<<、===、>>>），然后保存文件，再次 git add 和 git commit 就解决了。

第七章：Pull Request —— GitHub 的灵魂功能

Pull Request（简称 PR，中文叫"拉取请求"）是 GitHub 上最核心的协作方式。

它的工作流程是：

1. 你 Fork（复制）别人的仓库到你自己的账号下
2. 在你自己的仓库里修改代码
3. 向原作者发起一个 Pull Request，说"我改了一些东西，你看看要不要合并到你的项目里"
4. 原作者审查你的代码，可以选择接受（Merge）或拒绝

这就是开源社区运作的基本方式。全世界的程序员都是通过 Pull Request 来给开源项目贡献代码的。你不需要任何权限，只要 Fork 一下就能参与。

7.1 实战：给一个开源项目提 PR

1. 在 GitHub 上找到一个你感兴趣的开源项目
2. 点击右上角的 Fork 按钮，把这个项目复制到你的账号下
3. 把你 Fork 后的仓库克隆到本地：git clone 你Fork后的仓库地址
4. 创建一个新分支：git checkout -b fix-typo
5. 修改代码，提交：git add . && git commit -m "修复了一个拼写错误"
6. 推送到你的 GitHub：git push origin fix-typo
7. 回到 GitHub 网页，你会看到一条提示，点击 Compare & pull request
8. 写清楚你改了什么，点击 Create pull request

恭喜！你刚刚完成了人生中第一个开源贡献。

第八章：GitHub Pages —— 免费搭建个人网站

GitHub 还有一个隐藏的宝藏功能：GitHub Pages。它能把你仓库里的 HTML/CSS/JS 文件自动部署成一个网站，而且完全免费，自带 github.io 域名。

8.1 三步搭建

1. 创建一个仓库，仓库名必须是 你的用户名.github.io（比如 zhangsan.github.io）
2. 把仓库克隆到本地，在根目录创建一个 index.html 文件，写入简单的 HTML 内容
3. 提交并推送：git add . && git commit -m "初始化网站" && git push

等待一两分钟，打开浏览器访问 https://你的用户名.github.io，你的网站就上线了！

很多程序员和设计师都用 GitHub Pages 来搭建个人博客、作品集、项目文档站。比如大名鼎鼎的 Jekyll 和 Hugo 静态博客，都可以一键部署到 GitHub Pages 上。

第九章：GitHub Actions —— 自动化你的工作流

GitHub Actions 是 GitHub 内置的自动化引擎，可以让你在代码推送、PR 创建等事件发生时，自动执行一系列任务。

比如：

• 每次推送代码后，自动运行测试，确保代码没问题
• 每次合并 PR 后，自动部署网站到服务器
• 每天早上 8 点，自动抓取数据并更新仓库里的 JSON 文件

对于新手来说，可以先不用深入了解 Actions，但要知道 GitHub 有这个能力。等你需要的时候，搜索 "GitHub Actions 部署" 就能找到大量现成的配置模板。

第十章：GitHub Desktop —— 图形化操作

如果你实在不想记命令行，GitHub 官方提供了一个桌面客户端：GitHub Desktop。

下载地址：desktop.github.com

它把所有操作都变成了按钮：克隆仓库、提交更改、推送、拉取、创建分支、合并分支——全部点几下鼠标就能完成。对于不熟悉命令行的同学来说，这是一个非常好的过渡工具。

不过我还是建议，先用 Desktop 上手，再慢慢过渡到命令行。命令行虽然看起来有点吓人，但熟练之后效率远超图形界面。而且，几乎所有编程教程和文档都是用命令行来演示 Git 操作的，学会命令行意味着你能看懂更多资料。

第十一章：新手常见问题速查

Q1：push 的时候提示 "Permission denied"，怎么办？

GitHub 从 2021 年开始不再支持密码登录推送代码，需要用 Personal Access Token（个人访问令牌）代替密码。

解决方法：

1. 登录 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token
2. 勾选 repo 权限，生成 Token
3. 复制 Token（只显示一次，记得保存）
4. 之后 push 时输入密码的地方，粘贴这个 Token 即可

Q2：不小心 commit 了不该提交的文件（比如密码、API Key），怎么撤销？

# 撤销最近一次 commit，但保留文件修改
git reset --soft HEAD~1

然后修改 .gitignore 文件，把敏感文件排除掉，再重新提交。

Q3：.gitignore 是什么？

.gitignore 是一个文本文件，放在仓库根目录，用来告诉 Git "哪些文件不要追踪"。比如：

node_modules/    # 忽略 node_modules 文件夹
.env             # 忽略环境变量文件
*.log            # 忽略所有日志文件
.DS_Store        # 忽略 macOS 系统文件

创建仓库时可以在 GitHub 上选择模板（Node、Python、Java 等），自动生成合适的 .gitignore。

Q4：怎么把本地已有的项目上传到 GitHub？

# 在项目文件夹里初始化 Git
git init

# 关联远程仓库
git remote add origin https://github.com/你的用户名/仓库名.git

# 添加所有文件并提交
git add .
git commit -m "首次提交"

# 推送到 GitHub（第一次推送需要 -u 参数）
git push -u origin main

Q5：发现 GitHub 网站打不开或者很慢？

这是国内网络环境常见的问题。解决方法：

• 使用加速器或代理
• 修改 hosts 文件，添加 GitHub 的 IP 映射
• 使用国内的 GitHub 镜像站（如 kgithub.com）
• 使用 Watt Toolkit（原名 Steam++）等工具加速

第十二章：GitHub 不止是存代码

最后，我想告诉你 GitHub 真正的价值远不止"存代码"这么简单：

• 它是程序员的社交网络：你可以关注感兴趣的大神，看他们最近在做什么项目，Star（收藏）你觉得厉害的项目
• 它是全球最大的代码图书馆：你想实现的任何功能，基本上都能在 GitHub 上找到开源实现，搜索关键词就能找到
• 它是你的技术名片：面试的时候，把你的 GitHub 主页发给面试官，比你写十页简历都有说服力。持续的提交记录、规范的项目结构、清晰的 README 文档，都是你技术能力的直接证明
• 它是学习的最佳途径：看优秀开源项目的源码，读他们的 Issue 讨论，看他们如何组织代码、处理边界情况——这种学习方式比看书、看视频都高效

总结：你现在应该做什么？

如果你跟着这篇文章看到了这里，恭喜你，你已经从"完全不懂 GitHub"变成了"了解 GitHub 是什么、知道怎么用"。

接下来，建议你按这个顺序实操：

1. 注册 GitHub 账号，安装 Git
2. 配置用户名和邮箱
3. 创建一个测试仓库，写一个简单的 README.md
4. 练习 git clone、git add、git commit、git push 这四步操作
5. 试着创建一个分支，在分支上修改文件，然后合并回 main
6. 找一个简单的开源项目，Fork 一下，看看它的代码结构

这些操作大概需要 30 分钟到 1 小时。做过一遍之后，GitHub 的基本操作你就算掌握了。剩下的高级功能（CI/CD、Actions、Projects、Wiki）等需要的时候再学就行。

GitHub 就像一把瑞士军刀，入门只需要学会开瓶器和主刀，但它的其他功能会在你需要的时候派上用场。祝你在 GitHub 的世界里玩得开心！