🐍 Python Day92：Git 版本控制 — 代码的时光机
🕐 预计用时：3-4 小时 ｜ 🎯 目标：掌握 Git 基本操作、分支策略、团队协作流程
📖 今日目录
1. 为什么需要版本控制？
你写代码时有没有过这种经历？
project_v1.py
project_v2.py
project_v2_修改版.py
project_v2_修改版_最终版.py
project_v2_修改版_最终版_真的最终版.py
Git 就是来解决这个问题的——它记录你每一次修改，你可以随时回到任何一个时间点，还可以多人同时改同一个项目而不冲突。
2. Git 核心概念
2.1 三个区域
┌──────────┐ git add ┌──────────┐ git commit ┌──────────┐
│ 工作区 │ ──────────→ │ 暂存区 │ ──────────→ │ 仓库 │
│ Working │ │ Staging │ │ Repository│
│ Directory │ ←────────── │ Index │ ←────────── │ │
└──────────┘ git checkout └──────────┘ git reset └──────────┘
│
│ ← 你编辑文件的地方
│
- 工作区（Working Directory）
- 暂存区（Staging Area）
- 仓库（Repository）
2.2 文件状态
未跟踪 (Untracked) → 暂存 (Staged) → 已提交 (Committed)
新文件 git add git commit
还没被 Git 管理 准备好了 存入历史
3. 基本操作
3.1 初始化
# 在项目目录初始化 Git
cd my-project
git init
# 查看状态
git status
# 配置用户信息（首次使用）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
3.2 添加和提交
# 创建文件
echo "# My Project" > README.md
echo "print('hello')" > app.py
# 查看状态
git status
# On branch master
# Untracked files:
# README.md
# app.py
# 添加到暂存区
git add README.md # 添加单个文件
git add . # 添加所有文件
# 提交到仓库
git commit -m "初始提交：创建项目"
# 查看提交历史
git log --oneline
# a1b2c3d 初始提交：创建项目
3.3 修改和撤销
# 修改文件
echo "print('hello world')" > app.py
# 查看改了什么
git diff # 工作区 vs 暂存区
git diff --staged # 暂存区 vs 上次提交
# 添加修改
git add app.py
# 提交
git commit -m "修改 app.py"
# 撤销工作区的修改（回到上次提交的状态）
git checkout -- app.py
# 撤销暂存（从暂存区移回工作区）
git reset HEAD app.py
3.4 版本回退
# 查看提交历史
git log --oneline
# f4e5d6c 添加新功能
# a1b2c3d 初始提交
# 回退到某个版本（保留修改）
git reset --soft a1b2c3d
# 回退到某个版本（丢弃修改，危险！）
git reset --hard a1b2c3d
# 查看所有操作历史（包括回退）
git reflog
⚠️ git reset --hard 会丢失修改！永远不要在没有备份的情况下对公共分支使用。用 git stash 先暂存修改更安全。
4. 分支管理
4.1 分支是什么？
分支就像平行宇宙——你在自己的分支上随便折腾，不影响主线。搞定了再合并回来。
main: A ── B ── C ──────────────── F (合并)
\ /
feature: D ── E ─────┘
你在分支上开发新功能
4.2 分支操作
# 查看分支
git branch
# * main ← 当前分支
# 创建新分支
git branch feature-login
# 切换分支
git checkout feature-login
# 或者（Git 2.23+）
git switch feature-login
# 创建并切换（一步到位）
git checkout -b feature-login
# 在分支上开发
echo "def login(): pass" > auth.py
git add auth.py
git commit -m "添加登录功能"
# 切回主分支
git checkout main
# 合并分支
git merge feature-login
# 删除已合并的分支
git branch -d feature-login
4.3 合并冲突
# 两个人同时改了同一个文件的同一行
# main 分支:
print("Hello from main")
# feature 分支:
print("Hello from feature")
# 合并时会冲突
git merge feature
# CONFLICT (content): Merge conflict in app.py
# 打开文件，手动解决冲突
<<<<<<< HEAD
print("Hello from main")
=======
print("Hello from feature")
>>>>>>> feature
# 改成你想要的样子，然后:
git add app.py
git commit -m "解决合并冲突"
5. 远程仓库
5.1 GitHub / Gitee
# 在 GitHub 创建仓库后，关联远程仓库
git remote add origin https://github.com/yourname/my-project.git
# 推送到远程（第一次加 -u 设置默认）
git push -u origin main
# 之后直接
git push
# 从远程拉取
git pull
# 克隆别人的项目
git clone https://github.com/username/repo.git
5.2 SSH 配置（推荐）
# 生成 SSH 密钥
ssh-keygen -t ed25519 -C "your@email.com"
# 查看公钥
cat ~/.ssh/id_ed25519.pub
# 复制公钥，添加到 GitHub → Settings → SSH Keys
# 测试连接
ssh -T git@github.com
# Hi yourname! You've successfully authenticated...
# 用 SSH 地址关联
git remote add origin git@github.com:yourname/my-project.git
6. 协作流程
6.1 Fork + Pull Request（开源协作）
1. Fork 别人的仓库（GitHub 上点 Fork）
2. Clone 你 Fork 的仓库
git clone https://github.com/YOURNAME/repo.git
3. 创建新分支
git checkout -b fix-typo
4. 修改代码，提交，推送
git push origin fix-typo
5. 在 GitHub 上创建 Pull Request
6. 等待原作者 review 和合并
6.2 Git Flow（团队开发）
main ← 生产环境（只放稳定版本）
│
├── develop ← 开发主线
│ │
│ ├── feature/login ← 功能分支
│ ├── feature/search ← 功能分支
│ └── feature/payment ← 功能分支
│
├── release/1.0 ← 发布准备
│
└── hotfix/bug-123 ← 紧急修复
流程:
1. 从 develop 拉功能分支
2. 开发完成后合并回 develop
3. 准备发布时从 develop 拉 release 分支
4. 测试通过后合并到 main 并打 tag
5. 紧急 bug 从 main 拉 hotfix 分支
6.3 GitHub Flow（简单版，推荐）
main ← 永远可部署
│
└── feature-xxx ← 从 main 拉分支
│
├── commit 1
├── commit 2
└── commit 3
│
└── Pull Request → Review → Merge to main
适合: 持续部署的 Web 项目、小团队
7. Git 实用技巧
7.1 git stash（临时暂存）
# 改到一半，需要切分支修 bug
git stash # 暂存当前修改
git checkout hotfix-branch # 切去修 bug
# ... 修完 ...
git checkout main
git stash pop # 恢复之前的修改
# 查看暂存列表
git stash list
# 恢复指定暂存
git stash apply stash@{0}
7.2 git tag（版本标签）
# 打标签
git tag v1.0.0
git tag v1.0.0 -m "第一个正式版本"
# 推送标签到远程
git push origin v1.0.0
git push --tags # 推送所有标签
# 查看标签
git tag
7.3 git blame（谁改的）
# 查看每一行是谁最后修改的
git blame app.py
# a1b2c3d (Alice 2026-01-15) def hello():
# f4e5d6c (Bob 2026-02-20) print("world")
7.4 git bisect（二分查找 bug）
# 找到引入 bug 的那个 commit
git bisect start
git bisect bad # 当前版本有 bug
git bisect good v1.0.0 # v1.0.0 没有 bug
# Git 会自动二分，你只需要测试每个版本是 good 还是 bad
# 测试完后
git bisect reset
8. .gitignore
有些文件不应该被 Git 跟踪（编译产物、密码、缓存等）。.gitignore 文件告诉 Git 忽略它们。
# .gitignore 模板
# Python
__pycache__/
*.py[cod]
*$py.class
*.egg-info/
dist/
build/
*.egg
# 虚拟环境
venv/
.venv/
env/
# IDE
.vscode/
.idea/
*.swp
*.swo
# 环境变量（密码！）
.env
.env.local
# 日志
*.log
# 数据库
*.sqlite3
*.db
# OS 文件
.DS_Store
Thumbs.db
# 如果文件已经被跟踪，需要先移除缓存
git rm --cached .env
git commit -m "移除 .env 文件"
🎯 .gitignore 最佳实践：项目一开始就创建 .gitignore！不要等到 .env 已经被提交了才想起来。GitHub 提供了各种语言的模板：https://github.com/github/gitignore
9. 今日练习
练习 1：创建 Git 仓库
在你的 Python 项目目录执行 git init，完成一次完整的 add → commit → push 流程。
练习 2：分支操作
创建一个 feature 分支，修改代码后合并回 main，模拟一次团队协作。
练习 3：GitHub PR
在 GitHub 上 Fork 一个开源项目，修改 README 后提交 Pull Request。
10. 今日小结
| | |
|---|
git init | | |
git add | | |
git commit -m | | |
git push | | |
git pull | | |
git branch | | |
git merge | | |
git stash | | |
git log | | |
🎯 一句话总结：Git 是代码的时光机——add 选择要保存的，commit 拍快照，branch 开平行宇宙，merge 合并宇宙，push/pull 同步到云端。
🔮 明天预告：Day93 我们学习性能优化——profiling 定位瓶颈、内存管理、常见优化技巧、缓存策略。让你的 Python 代码飞起来！
10个月宝宝每天需要喝多少奶粉？