第03章：Git 存档与版本管理

Git 让你能随时回到文件的任何历史版本

📌 章节说明

前置知识：已完成第02章，熟悉 Claude Code 基本操作。

本章价值：Git 是开发者的"时光机"，让你随时能回到过去的任何一个版本。用 Claude Code 操作 Git，不需要记住任何 Git 命令。

Git 是什么？

Git 就像文件的 "时光机"

┌────────────────────────────────────────┐
│                                        │
│   今天 → 明天 → 后天                    │
│    ↓       ↓       ↓                   │
│  版本1   版本2   版本3                  │
│                                        │
│   随时可以回到任何一个版本！             │
│                                        │
└────────────────────────────────────────┘
                    

为什么需要 Git？

场景	没有 Git	有 Git
改错了	没办法，重来	一键回退
想对比	不记得改了啥	清楚看到差异
多版本	file_v1、file_v2、file_final...	自动管理
误删除	文件没了，永远没了	随时恢复

🎯 用 Claude Code 操作 Git 的优势

传统方式：

❌ 需要记一堆命令（git add, git commit, git push...）
❌ 命令参数复杂，容易出错
❌ 不知道什么时候该用什么命令

用 Claude Code：

✅ 用自然语言描述即可
✅ Claude 自动选择合适的命令
✅ 不需要记任何 Git 命令

第一步：安装 Git（5分钟）

Windows 用户

访问 git-scm.com
下载 Windows 版本
运行安装程序，一路 Next 即可
验证：打开命令行，输入 git --version

terminal

git --version
# 应该显示类似：git version 2.43.0.windows.1

Mac 用户

Mac 系统通常已经自带 Git。

bash

# 检查是否已安装
git --version

# 如果没有，系统会提示安装 Xcode Command Line Tools
# 按提示安装即可

第二步：第一次初始化 Git（10分钟）

创建一个测试项目

terminal

# 创建项目文件夹
 mkdir my-first-git
 cd my-first-git

# 启动 Claude Code
claude

让 Claude 帮你初始化

在 Claude Code 中输入：

请帮这个文件夹初始化 Git，并创建第一个存档，提交信息写 "初始版本"

🔍 Claude 会自动做什么？

运行 git init 初始化仓库
创建 .gitignore 文件（忽略不需要存档的文件）
运行 git add . 添加所有文件
运行 git commit -m "初始版本" 创建存档

第三步：日常存档（15分钟）

修改文件后存档

我修改了一些文件，请帮我 Git 存档，提交信息写 "更新了登录功能"

🔍 Claude 会自动做什么？

检查哪些文件被修改了
运行 git add . 添加修改
运行 git commit 创建存档

良好的提交信息写法

好的提交信息 ✅	不好的提交信息 ❌
"修复了登录页面的样式问题"	"更新"
"新增了用户头像上传功能"	"改了一些东西"
"更新了 README 文档"	"123"

💡 原则

提交信息要清晰描述"做了什么"，让未来的你看到就知道改了什么。

第四步：查看历史和差异（10分钟）

查看历史记录

请显示 Git 历史记录

你会看到类似：

                        commit 1: 修复了登录 bug (今天 14:30)

                        commit 2: 更新了首页样式 (今天 10:00)

                        commit 3: 初始版本 (昨天 16:00)

查看某个版本改了什么

请显示当前版本和上一个版本的差异

第五步：回退到之前的版本（5分钟）

回退操作

请回退到上一个版本

或者指定具体版本：

请回退到 "更新了首页样式" 那个版本

恢复误删的文件

我不小心删除了 config.py，请从 Git 恢复

常用场景

场景1：开始新功能前先存档

Git 存档当前状态，提交信息写 "开始新功能前的稳定版本"

好处：如果新功能改乱了，随时可以回退到这个稳定版本。

场景2：改错了想回退

我刚才的改法有问题，请回退到上一个版本

场景3：查看改了什么

请显示我这次修改了哪些内容

场景4：只想存档部分文件

我只想存档 index.html 和 style.css，其他文件暂不提交

场景5：放弃所有未提交的修改

请放弃所有未提交的修改，恢复到上次存档的状态

警告：这个操作会删除所有未保存的修改，请谨慎使用！

场景6：对比两个版本的差异

请对比 "初始版本" 和 "更新了首页样式" 这两个版本的差异

场景7：查看某个文件的修改历史

请显示 index.js 这个文件的修改历史

不需要记住的 Git 命令

用 Claude Code，你不需要记这些命令：

命令	用途	Claude 帮你执行
`git init`	初始化仓库	✅
`git add`	添加文件到暂存区	✅
`git commit`	创建存档	✅
`git log`	查看历史	✅
`git diff`	查看差异	✅
`git reset`	回退版本	✅
`git revert`	撤销提交	✅
`git checkout`	恢复文件	✅
`git status`	查看状态	✅

🎯 总结

你只需要用自然语言告诉 Claude 你想做什么！

本章自检（3分钟）

点开问题查看答案，能讲清楚就算掌握。

为什么学习 Claude Code 一定要学 Git 存档？

因为 AI 可能改错文件；Git 能让你随时回退到“改之前”的状态，心理更稳，操作更大胆。

把当前状态“存一份档”的最核心命令是什么？

通常是：git add -A 然后 git commit -m \"说明\"（不同项目流程可能略有差异）。

怎么查看历史记录，找到可以回退的版本？

用 git log 查看提交历史，找到对应的 commit。

回退版本前，最安全的习惯是什么？

先再存一次档（或确认工作区干净），避免把当前未保存的修改弄丢。