GitHub 完全使用教程（新手必读）

本文档详细讲解 GitHub 所有功能、按钮的用途和作用，适合零基础新手入门

文章内容若有错误的地方，请留言，后续及时改正

文档版本：2026年7月

适用对象：GitHub 零基础新手

📑 目录

1. GitHub 是什么

GitHub 是全球最大的代码托管平台和协作开发平台。

核心作用：

• 📦 代码托管：保存你的代码，支持版本管理

• 👥 协作开发：多人同时开发同一个项目

• 🔄 版本控制：记录每次修改，随时回退

• 🤝 开源社区：学习和参与全球开源项目

• 🚀 自动化部署：自动测试和发布代码

GitHub 的核心概念：

2. 注册账号

2.1 注册步骤

2.2 注册后必做的设置

（1）验证邮箱

• 登录邮箱，点击 GitHub 发送的验证链接

（2）设置头像

• 点击右上角头像 → Settings → Profile → Picture（上传图片）

（3）开启两步验证（2FA） ⭐ 非常重要

• Settings → Password and authentication → Enable two-factor authentication

• 推荐使用 Authenticator App（如 Google Authenticator）

（4）添加 SSH 密钥（可选，推荐）

• Settings → SSH and GPG keys → New SSH key

• 用于免密码推送代码

3. 首页（Home）所有按钮说明

登录后看到的首页包含以下功能区域：

3.1 左侧栏

3.2 中间动态流（Feed）

3.3 右侧栏

4. 顶部导航栏（Global Navigation）

顶部导航栏在每个页面都会显示，包含以下按钮：

4.1 左侧

4.2 右侧

4.3 点击头像后的下拉菜单

4.4 点击 + 号后的下拉菜单

5. 仓库页面（Repository）所有功能按钮

仓库页面是 GitHub 最核心的页面，包含以下标签和功能：

5.1 仓库顶部信息区

5.2 ⭐ Star 按钮详解

5.3 👁 Watch 按钮详解

5.4 🍴 Fork 按钮详解

Fork 的作用：

• 复制别人的项目到你账号

• 修改后可以向原作者提交 PR

• 不影响原始项目

5.5 代码区（Code Tab）

这是默认打开的页面，显示代码文件列表：

5.6 Add file 下拉菜单

5.7 Code 下拉菜单

5.8 文件查看页面

点击文件后进入查看页面：

5.9 仓库标签页（Tabs）

仓库顶部有一排标签页：

6. Issues（问题追踪）完整功能

6.1 Issues 页面按钮

6.2 创建 Issue 页面

6.3 Issue 详情页按钮

6.4 Issue 中的常用语法

# 引用其他 Issue
#123       → 链接到 Issue 123
Fixes #123 → 合并时自动关闭 Issue 123
Closes #123, #124 → 关闭多个 Issue
​
# 提及用户
@username → 通知某人
​
# 任务列表
– [x] 已完成
– [ ] 待完成
​
# 代码块
```python
print("Hello")

6.5 Labels（标签）

标签用于分类和标记 Issue/PR：

你可以自定义标签：

• 点击 Labels → New label

• 输入标签名称、描述、选择颜色

6.6 Milestones（里程碑）

里程碑用于版本规划：

7. Pull Request（PR）完整功能

7.1 PR 页面按钮

7.2 创建 PR 页面

7.3 PR 详情页按钮

7.4 PR 的合并方式

点击 Merge pull request 旁边的 ▼ 可选择合并方式：

7.5 Code Review（代码审查）

在 Files changed 标签页：

7.6 Draft PR（草稿 PR）

草稿 PR 的作用：

• 表示"还在开发中"

• 不会被合并

• 方便早期讨论和反馈

8. Actions（自动化CI/CD）

8.1 Actions 页面按钮

8.2 Workflow 详情页

8.3 Workflow 文件

Workflow 文件存放在 .github/workflows/ 目录下，格式为 .yml：

name: CI
​
on:
push:
  branches: [ main ]
pull_request:
  branches: [ main ]
​
jobs:
build:
  runs-on: ubuntu-latest
  steps:
  – uses: actions/checkout@v4
  – name: Run tests
    run: npm test

8.4 触发事件

9. Projects（项目管理）

9.1 Projects 页面

9.2 项目面板功能

9.3 与 Issue/PR 关联

• 在 Issue/PR 右侧面板可以关联 Project

• 在 Project 中可以直接创建 Issue

• PR 合并后自动更新状态

10. Wiki（文档百科）

10.1 Wiki 页面按钮

10.2 Wiki 功能

11. Security（安全功能）

11.1 Security 页面标签

11.2 安全功能详解

11.3 配置 Dependabot

创建 .github/dependabot.yml：

version: 2
updates:
– package-ecosystem: "npm"
  directory: "/"
  schedule:
    interval: "weekly"

12. Insights（数据洞察）

12.1 Insights 页面标签

12.2 统计图表

13. Settings（设置）所有选项详解

仓库 Settings 页面包含以下所有选项：

13.1 General（常规设置）

13.2 Access（访问权限）

13.3 Code and automation（代码和自动化）

13.4 Security（安全）

13.5 Integrations（集成）

13.6 分支保护规则（Branch protection rules）

点击 Add rule 后：

13.7 Webhooks

13.8 Secrets and variables

Secrets vs Variables：

• Secrets：加密存储，日志中隐藏（用于密码、API 密钥）

• Variables：明文存储（用于配置值、环境名）

14. 个人主页（Profile）

14.1 个人主页内容

14.2 个人主页标签

14.3 贡献热力图（Contribution Graph）

贡献包括：

• 提交代码（Commit）

• 创建 PR

• 创建 Issue

• Code Review

14.4 置顶仓库（Pinned Repositories）

14.5 Profile README

创建一个与用户名相同的仓库，添加 README.md，内容会自动显示在个人主页。

15. 组织（Organization）

15.1 创建组织

15.2 组织页面标签

15.3 Teams（团队）

15.4 People（成员管理）

16. GitHub Marketplace

16.1 功能

16.2 常用应用类别

17. GitHub Codespaces

17.1 什么是 Codespaces

• 基于云的开发环境

• 在浏览器中运行完整的 VS Code

• 自动配置开发工具和依赖

17.2 使用方式

17.3 Codespaces 页面按钮

17.4 devcontainer 配置

在 .devcontainer/devcontainer.json 中配置：

{
 "name": "My Dev Container",
 "image": "mcr.microsoft.com/devcontainers/javascript-node:20",
 "forwardPorts": [3000],
 "postCreateCommand": "npm install"
}

18. GitHub Copilot

18.1 功能

18.2 订阅计划

18.3 使用方式

19. GitHub Discussions

19.1 功能

19.2 讨论分类

19.3 启用 Discussions

• Settings → Features → 勾选 Discussions

• 或点击 Set up discussions

20. GitHub Sponsors

20.1 功能

20.2 设置赞助

• Settings → Sponsors

• 填写描述和赞助等级

• 连接 Stripe 或 PayPal

21. GitHub API

21.1 REST API

21.2 GraphQL API

query {
repository(owner: "facebook", name: "react") {
  stargazerCount
  forkCount
  issues(states: OPEN) {
    totalCount
  }
}
}

21.3 认证方式

21.4 速率限制

22. GitHub CLI（命令行工具）

22.1 安装

# macOS
brew install gh
​
# Windows
winget install GitHub.cli
​
# Linux
sudo apt install gh

22.2 登录

gh auth login

22.3 常用命令

23. GitHub Pages（静态网站）

23.1 启用 Pages

• Settings → Pages

• 选择源分支和目录

• 点击 Save

23.2 站点类型

23.3 自定义域名

23.4 静态站点生成器

24. GitHub Packages（包管理）

24.1 支持的包类型

24.2 使用 GHCR（GitHub Container Registry）

# 登录
echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME –password-stdin
​
# 拉取镜像
docker pull ghcr.io/OWNER/IMAGE:tag
​
# 推送镜像
docker tag my-image ghcr.io/OWNER/IMAGE:latest
docker push ghcr.io/OWNER/IMAGE:latest

25. Git 基础操作命令

25.1 安装与配置

# 安装 Git
# Windows: https://git-scm.com
# macOS: brew install git
# Linux: sudo apt install git
​
# 配置身份
git config –global user.name "你的名字"
git config –global user.email "你的邮箱"
​
# 查看配置
git config –list

25.2 核心命令

# ========== 初始化与克隆 ==========
git init                          # 初始化本地仓库
git clone <url>                   # 克隆远程仓库
git clone –depth 1 <url>         # 浅克隆（只取最新提交）
​
# ========== 日常操作 ==========
git status                        # 查看状态
git add <file>                    # 添加文件到暂存区
git add .                         # 添加所有变更
git commit -m "提交说明"           # 提交到本地仓库
git push origin main              # 推送到远程
git pull origin main              # 拉取远程更新
git fetch                         # 拉取但不合并
​
# ========== 查看历史 ==========
git log                           # 查看提交历史
git log –oneline –graph         # 图形化简洁历史
git show <commit-hash>            # 查看某次提交详情
git diff                          # 查看未暂存的变更
git diff –staged                 # 查看已暂存的变更
​
# ========== 撤销操作 ==========
git restore <file>                # 撤销未暂存的修改
git restore –staged <file>       # 取消暂存
git reset –soft HEAD~1           # 撤销最近一次提交（保留修改）
git reset –hard HEAD~1           # 撤销最近一次提交（丢弃修改）
git revert <commit-hash>          # 创建一个反向提交（安全撤销）
​
# ========== 分支操作 ==========
git branch                        # 查看分支
git branch <name>                 # 创建分支
git checkout <name>               # 切换分支
git checkout -b <name>            # 创建并切换
git switch <name>                 # 切换分支（新语法）
git switch -c <name>              # 创建并切换（新语法）
git merge <branch>                # 合并分支
git branch -d <name>              # 删除已合并分支
git branch -D <name>              # 强制删除分支
git push origin –delete <name>   # 删除远程分支
​
# ========== 远程操作 ==========
git remote -v                     # 查看远程仓库
git remote add origin <url>       # 添加远程仓库
git remote set-url origin <url>   # 修改远程地址

25.3 .gitignore

# 忽略 node_modules 目录
node_modules/
​
# 忽略环境变量文件
.env
.env.local
​
# 忽略 IDE 配置
.idea/
.vscode/
​
# 忽略构建输出
dist/
build/
​
# 忽略操作系统文件
.DS_Store
Thumbs.db

25.4 Git 工作区原理

工作区 (Working Directory)
  ↓ git add
暂存区 (Staging Area / Index)
  ↓ git commit
本地仓库 (Local Repository)
  ↓ git push
远程仓库 (Remote Repository)

26. 新手常见问题

Q1：Git 和 GitHub 有什么区别？

• Git：版本控制软件，安装在本地电脑上

• GitHub：基于 Git 的代码托管网站

Q2：Public 和 Private 仓库有什么区别？

• Public：所有人都能看到你的代码

• Private：只有你和授权的人能看到

Q3：Fork 和 Clone 有什么区别？

• Fork：在 GitHub 上复制仓库到你账号（远程操作）

• Clone：将仓库下载到本地电脑（本地操作）

Q4：如何参与开源项目？

Q5：PR 被拒绝了怎么办？

Q6：如何删除仓库？

• Settings → 最底部 → Delete this repository

• 输入仓库名确认删除

Q7：如何修改仓库名称？

• Settings → General → Repository name → Rename

Q8：如何转让仓库？

• Settings → General → Transfer ownership

Q9：如何恢复误删的分支？

# 查看历史操作记录
git reflog
​
# 找到删除前的 commit hash，然后
git checkout -b <branch-name> <commit-hash>

Q10：提交信息写错了怎么办？

# 修改最近一次提交信息
git commit –amend -m "新的提交信息"
​
# 如果已经 push 了，需要强制推送
git push –force

📌 常用快捷键

🔗 官方资源

📝 提示：本文档涵盖了 GitHub 的所有主要功能和按钮。建议收藏本文档，遇到问题时随时查阅。

💡 记住：学习 GitHub 最好的方式就是动手实践。创建一个测试仓库，尝试所有功能，遇到问题就查阅本文档。