📖 中学生也能看懂 · 文科生也能上手

Git & GitHub

完全入门指南

从核心概念到团队协作,从开源贡献到 AI 时代的 Vibe Coding——深入浅出,一看就懂

核心概念 开发流程 开源协作 命令速查 实战场景 AI 新时代

首先,Git 和 GitHub 是两回事

🛠️

Git = 工具

装在你电脑上的"版本管理软件"。就像游戏里的存档系统——随时存档,随时回档。

☁️

GitHub = 平台

把存档放到网上的云端平台。队友也能看到、下载、一起改。类似的还有 GitLab、Gitee。

这些术语到底是什么意思?

点击卡片展开详细解释和生活化比喻。

📁
Repository 仓库
你的项目文件夹 + 所有历史版本

Repository(简称 Repo)就是一个项目的"大文件夹"。里面放着所有代码、文档、图片,还有一个隐藏的 .git 文件夹记录全部版本历史。

🎮 游戏比喻

Repo 就像一个游戏的存档目录,保存了从开始到现在的所有存档记录。

💾
Commit 提交
按一次"存档"按钮

每次代码改得差不多了,做一次 Commit。它记录:改了哪些文件、什么内容、谁改的、什么时间、以及一段描述信息。

🎮 游戏比喻

就像在游戏里按下"保存"——在关键节点存档,以后可以随时回到这里。

🌿
Branch 分支
平行宇宙——不影响主线的自由探索

main 分支是正式版本。新建分支就是复制一份草稿,随便改不影响正式版。满意了再"合并"回去。

main: A ── B ── C ──────────── G (合并后) \ / feature: D ── E ── F

main 主分支 · develop 开发分支 · feature/xxx 功能分支 · bugfix/xxx 修 Bug

🔀
Merge 合并
把两个平行宇宙合在一起

分支工作完成后合并回主分支。Git 自动整合修改。改了同一行代码会产生"冲突",需手动决定。

💡 理解冲突

两人同时改了同一句歌词——Git 不知道该用谁的,需要你来决定。

📋
Pull Request PR
请求审核的"申请单"——GitHub 最核心的协作机制

PR 的意思是:"我改好了代码,请审查一下,没问题就合并到主分支。"

流程:创建分支 → 写代码 → 提 PR → Code Review → 讨论修改 → 通过 → 合并!

🏫 校园比喻

PR 就像交作业——写好了交给老师(Reviewer),老师批改后说"通过"。作业进入"优秀作品集"(main 分支)。

🍴
Fork 复刻
把别人的项目复制到自己的账号下

别人的项目你没权限直接改。Fork 到自己账号后,你有完全权限。改好后再向原项目提 PR。

🍽️ 美食比喻

Fork 就像在餐厅看到食谱,拍照带回家改良,然后告诉原厨师:"加点辣椒更好吃,试试?"

🔄
Clone & Push & Pull
下载、上传、同步

Clone:完整下载项目到本地。Push:上传到 GitHub。Pull:从 GitHub 下载最新修改。

🎮 游戏比喻

Clone=下载完整存档;Push=上传云端;Pull=从云端同步最新存档。

🖥️
Worktree 工作树
同时打开多个分支,互不干扰

正常一次只能在一个分支工作。Worktree 让你同时打开多个分支,每个一个独立文件夹。Claude Code 用 --worktree 深度支持此功能。

# 在当前项目旁创建新工作树
git worktree add ../my-feature feature/login

更多概念速查

概念说明比喻
git add选择哪些修改要存档拍照前选谁入镜
stash临时把修改藏起来东西先塞抽屉
tag给版本打标签重要页面贴标签纸
Issue问题追踪待办清单
.gitignore忽略某些文件"这些不用存档"

团队平时怎么用 Git 开发?

个人开发
小团队
Git Flow
主干开发

一个人玩——最简单的循环

git init              # 创建仓库
# ✏️ 写代码...
git add .             # 选择存档文件
git commit -m "描述"   # 存档
git push              # 上传到 GitHub

Feature Branch——最常见的团队方式

1

拉取最新代码

git pull origin main

2

创建功能分支

git checkout -b feature/search

3

写代码 & 测试

在分支上自由开发

4

提交并推送

git add . && git commit && git push

5

创建 PR

在 GitHub 上说明改了什么

6

Review → 合并

审核通过后合并到 main

Git Flow——大项目规范流程

main ●━━━━━━━━━━━━━━━━━━━● 正式版本 develop ●━━●━━━●━━━━●━━━● 开发主线 │ │ │ feat/A feat/B release

main 发布版 · develop 开发 · feature/* 功能 · release/* 测试 · hotfix/* 紧急修复

Trunk-Based——Google/Meta 大厂用法

main ── A ── B ── C ── D ── E ── F 小明 小红 小华 (当天合并) (当天合并) (当天合并)

改动小而快 · 自动化测试 · Feature Flag 控制

开源项目几千人怎么协作?

像 Linux、React、Vue.js 用 Fork + PR 模式。

1

Fork 项目

点 "Fork",复制到你账号下

2

Clone 到本地

git clone https://github.com/你/项目.git

3

创建分支 & 修改

读 CONTRIBUTING.md → 找 good first issue → 写代码

4

推送到你的 Fork

git push origin fix/improvement

5

创建 PR

向原项目提交 Pull Request

6

讨论 → 合并

维护者审核,恭喜成为贡献者!

Maintainer

核心管理者,审核 PR

Contributor

提交代码、文档、Bug 报告

Reviewer

审查代码质量

Committer

有直接提交权限的核心成员

最常用的 Git 命令

基础操作

git init                    # 初始化新仓库
git clone <url>             # 克隆远程仓库
git status                  # 查看当前状态
git add .                   # 添加所有修改
git commit -m "描述"         # 提交
git push                    # 推送到远程
git pull                    # 拉取最新

分支 & 撤销

git checkout -b <名字>      # 创建并切换分支
git merge <名字>            # 合并分支
git stash / git stash pop   # 暂存/恢复修改
git log --oneline           # 简洁历史
git reset --soft HEAD~1     # 撤销提交(保留修改)
git revert <commit>         # 安全撤销

遇到这些情况怎么办?

和同事改了同一个文件,冲突了!
<<<<<<< HEAD
你的代码
=======
同事的代码
>>>>>>> feature/other
💡 预防冲突

经常 pull · 各人改不同模块 · 分支尽快合并

提交了错误的 Commit?
# 没 push → 撤回但保留修改
git reset --soft HEAD~1
# 已 push → 安全撤销
git revert <commit-hash>

Commit Message 最佳实践

"更新代码"
"修复 Bug"
feat: 添加用户搜索功能
fix: 修复用户无法重置密码的问题
docs: 更新 API 文档示例代码

AI 时代的 Git/GitHub——Vibe Coding 与新工作流

2025-2026 年,AI 工具彻底改变了 Git 和 GitHub 的使用方式。你不需要记住复杂命令,甚至不需要会写代码,也能参与软件开发和开源项目。

什么是 Vibe Coding?

Vibe Coding(氛围编程)由 Andrej Karpathy 提出:你用自然语言描述想要什么,AI 来写代码。就像告诉装修工人"我要北欧风客厅"——你不用刷墙铺地板,但要懂得描述需求、检查质量。

工具类型特点与 Git 的关系
Claude Code终端代理自然语言操控,理解整个代码库原生 Git + 自动 PR
CursorAI IDEVS Code 增强版,Background Agent内置 GitHub,自动提 PR
GitHub CopilotGitHub 原生Agent HQ 多代理平台最深度 GitHub 集成
OpenCode开源终端75+ 模型,完全开源Git 原生支持
WindsurfAI IDE性价比高 $15/月Git 工作流支持

传统方式 vs AI 时代

😰 以前(2023年前)

手动输入 git 命令
自己写代码
自己写 commit message
自己写 PR 描述
人工 code review
手动修复 review 意见

🚀 现在(2026年)

自然语言告诉 AI 需求
AI 自动创建分支、写代码、测试
AI 生成有意义的 commit message
AI 自动创建 PR 并写描述
BugBot/AI 自动初步审查
AI 根据反馈自动修复

GitHub Agent HQ——多 AI 协作的新时代

2026 年 2 月,GitHub 推出 Agent HQ,直接在 GitHub 上使用多个 AI Agent:

🤖

@copilot / @claude / @codex

在 Issue 里 @claude 说"实现这个功能"→ Claude 自动创建分支、写代码、提 PR。可以给同一个 Issue 分配多个 Agent 对比方案。

🤯 真实数据

Cursor 公司超过 35% 的已合并 PR 由 AI Agent 自主创建。2026 年 3 月的 Cursor Automations 甚至能自动响应告警、查日志、修 Bug、提 PR——全程无人参与。

Claude Code + Git 实操

# 启动 Claude Code,用自然语言操作 Git:

"帮我创建分支 feature/search 并实现搜索功能"
# → Claude 自动: checkout -b + 写代码

"把修改提交,写个好的 commit message"
# → Claude 自动: add + commit -m "feat: 实现关键词搜索"

"推到 GitHub 并创建 PR"
# → Claude 自动: push + 创建 PR 并写描述

Worktree 多任务并行:

claude --worktree feature-auth    # 窗口1: 开发登录
claude --worktree bugfix-123      # 窗口2: 修 Bug
# 两个 AI 各自独立工作,互不干扰

🔥 文科生和非技术人员如何用 AI 参与开源

你不需要会写代码也能参与开源项目了!

📝

1. 改善文档和翻译(最容易上手)

用 AI 理解技术文档 → 翻译成中文 → 改写得更通俗 → AI 帮你创建 PR

🐛

2. 报告 Bug

发现问题 → AI 帮写清晰 Bug 报告(Issue)→ 提供复现步骤

3. 用 AI 直接修改代码

在 Cursor 中:"把按钮改成绿色"、"添加公告栏"、"修复手机显示"。AI 写代码,你看效果。

🎨

4. 设计和 UI 改进

Issue 中提设计建议 → Figma 做稿 → AI(v0.dev)转代码 → 提 PR

真实案例

案例 1:大学教授用 Claude Code 做学术开源

一位不懂编程的教授,用 claude-code-my-workflow 模板管理 LaTeX 论文和 Beamer 演示,项目用 10 个 AI Agent 自动审查质量。已在 GitHub 形成学术开源社区。

案例 2:3600 万新开发者涌入 GitHub

2025 年 GitHub 报告:AI 帮 3600 万新开发者加入,很多是非专业程序员。AI 帮新手理解代码、起草补丁、从零创建项目。

案例 3:OpenClaw——21万星的开源典范

2026 年增长最快的开源项目。非技术人员通过 Telegram/WhatsApp 用自然语言操控 AI 代理,实现自动化。项目本身就是开源社区协作的范本。

AI 自动参与开源的前沿实践

Claude Code GitHub Action

Anthropic 官方方案:PR 中 @claude 代码审查;Issue 中 @claude 自动实现功能;定时自动更新文档;自动生成测试。

BugBot——自动审查每个 PR

扫描逻辑错误、安全漏洞、代码风格、性能问题。检出率超 70%,平均每 PR 发现 0.7 个 Bug。

Agent HQ 多代理对比

给同一个 Issue 分配 Copilot、Claude、Codex,对比方案:一个检查架构,一个测试边界,一个追求最小改动。

2026 年 AI + Git 最佳实践

给初学者 / 非技术人员

① 从文档贡献开始
② 善用 good first issue
③ AI 当翻译官——不懂就让 AI 解释
④ 用 Cursor / Claude Code 修改
⑤ 认真写 PR 描述

给团队 / 企业

① 创建 CLAUDE.md 告诉 AI 规范
② GitHub Action 集成 AI 审查
③ 多 Agent 对比方案
④ 人类最终决策权
⑤ 建立 AI 审计日志

🧠 核心原则

AI 是强大的"副驾驶",但方向盘始终在你手中。理解前面的基础概念,才能更有效地指挥 AI。Git/GitHub 正在成为所有知识工作者协作的基础设施——无论你是否写代码。