git-AI时代的存档基建

不会命令行？没关系。用对话让 Claude Code 帮你搞定版本管理

前提：本文假设你已经安装了 Claude Code 或者 OpenCode。Mac 系统自带 Git，Windows 用户第一次使用时 CC 会提示你安装，跟着提示操作即可。安装教程可以看这里：

【之前安装配置公众号文章连接】

你用 AI 写了一个实证分析脚本，300 行代码，跑出来的结果很漂亮。第二天你又让 AI 改了几个控制变量，结果全变了。你想回到昨天的版本——但你已经覆盖了原来的文件。

AI 时代的科研写作，变化太快、太多，人脑根本记不住每一步修改。这就是为什么你需要 Git：一个能记录每一步、随时回到过去的时光机。

Git 是什么？为什么科研人需要它？

一个熟悉的痛苦

你大概经历过这种事：

• 第一天：写好了引言和文献综述，保存为 paper_v1.tex
• 第三天：导师让修改，改成了 paper_v2_导师意见.tex
• 第五天：加了实证分析，变成 paper_v3_加实证_最终版.tex
• 第七天：导师说「删了的那段其实更好」，你翻遍文件夹也找不到原版

Git 就是解决这个问题的。它自动记录每次修改——什么时候改的、改了什么（对纯文本文件能精确到行）、为什么改（你自己写的备注）。随时可以一键回到任何一个历史版本。

你已经有云盘了，为什么还要 Git？

你可能会想：我用坚果云 / OneDrive 也有版本历史啊？

云盘的版本历史是「按时间自动备份」——它不知道哪一版是你跑出理想结果的那个回归。你只能在几十个自动保存中逐个翻找。而 Git 的每一次存档都是你主动触发的，有明确的备注告诉你这一版改了啥。三个月后你还能立刻定位到「那个结果显著的 IV 回归版本」。

六个核心概念

• 仓库 (Repository)：一个项目的「档案柜」。就像你的论文文件夹。
• 提交 (Commit)：拍一张「快照」，保存当前状态。就像点击「保存」，但附带修改说明。
• 分支 (Branch)：一条独立的时间线。就像论文的「中文投稿版」和「英文投稿版」并行撰写。
• 回滚 (Rollback)：回到之前的快照。导师说「删了的那段更好」，一键恢复。
• 推送 (Push)：把本地存档同步到云端。就像把论文同步到 Overleaf 或坚果云。
• 合并 (Merge)：把两条时间线合起来。就像把「方法章节修改」合并到「主论文」。

3 分钟搭建你的第一个 Git 仓库

你不需要记住任何命令。只需要打开 Claude Code，用自然语言跟它对话。

项目文件夹示例

一个典型的实证研究项目文件夹：

• data.csv（原始数据）
• clean_data.py（数据清洗代码）
• analysis.R（回归分析代码）
• paper.tex（LaTeX 论文草稿）

第一步：初始化

对 CC 说：

帮我把当前项目初始化成 Git 仓库，方便后续管理版本。

CC 会帮你完成：

Claude: ✅ 已初始化 Git 仓库！

完成事项：
1. 创建了 .git 文件夹（Git 的档案柜）
2. 创建了 .gitignore 文件，自动忽略不需要存档的文件
   - 忽略的项：*.log, .DS_Store, __pycache__/, .env
3. 所有现有文件已标记为「待存档」

接下来，你可以选择：
- 说「保存当前版本」，我把现在的文件全部提交
- 或者先告诉我哪些文件不需要存档

第二步：保存第一个版本

用 Git 保存当前版本，备注：项目初始状态，包含原始数据和清洗代码

Claude: ✅ 已保存（提交）！

存档信息：
- 时间: 2026-04-29 10:30
- 备注: "项目初始状态，包含原始数据和清洗代码"
- 涉及文件: 4 个
- 存档编号: a1b2c3d

你的项目现在有了第一个「检查点」，随时可以回到这个状态。

日常科研的三个核心场景

下面三个场景覆盖了你在科研中 90% 会用到的 Git 操作。每个场景都是真实工作中会碰到的。

场景一：改完代码，让 CC 帮你智能提交

你修改了 clean_data.py，添加了缺失值处理逻辑。对 CC 说：

我修改了数据清洗代码，帮我用 Git 保存这个版本。

Claude: 让我看看改了什么...

🔍 检测到以下变更：
- 修改: clean_data.py
  - 新增: 缺失值填充函数 fill_missing_values()
  - 新增: 异常值检测逻辑（IQR 方法）

💡 建议存档备注：
"feat: 添加缺失值处理和异常值检测"

确认保存吗？
- 说「确认」→ 直接保存
- 说「修改备注」→ 你重写备注

User: 修改备注，重点是缺失值处理，异常值检测只是顺带的

Claude: 没问题，更新为：
"feat: 添加缺失值填充，附带异常值检测"

User: 确认

Claude: ✅ 已保存！
- 1 个文件变更
- +45 行 -8 行
- 存档编号: b2c3d4e

注意这段对话里的小细节：CC 生成的备注不够精准，你纠正了一下。这是正常现象——CC 不是神，你需要跟它沟通。但和记命令相比，说一句话纠正备注的成本几乎为零。

场景二：论文改到一半，先存档去开会

你正在重写论文的实证部分，改了一半，导师喊你开会。

我先 Git 存档一下现在的进度，去开个会，备注里写清楚这是未完成的。

Claude: 收到！让我看看当前状态...

⚠️ 检测到 paper.tex 有未完成的修改：
- 实证部分重写了约 60%（新增稳健性检验小节）
- 有 TODO 注释: "% TODO: 补充内生性讨论"

💡 建议：创建一个「进行中」存档

存档备注："WIP: 重写实证部分（60%），待补充内生性讨论"

需要我：
1. 直接保存这个「进行中」版本？
2. 还是创建一个新分支来保存？

User: 直接保存

Claude: ✅ 已保存为「进行中」版本！
- 存档编号: c3d4e5f
- 标签: WIP-empirical-rewrite

回来后可以说「继续修改论文」，我会定位到这个进度。

WIP（Work In Progress）存档是个很实用的习惯。它让你可以随时中断工作，回来时 CC 会自动告诉你上次停在哪。

场景三：AI 改了回归模型，结果不对，回滚！

你让 AI 调整了回归模型的控制变量，跑完之后发现结果全变了，符号都不对。

刚才的修改有问题，结果完全不对，我要 Git 回滚到上一个稳定版本。

Claude: ⚠️ 让我确认一下要回滚的范围...

上次存档之后改了 3 个文件。其中 paper.tex 的改动比较大，
建议你确认一下我列出的变更是否准确（我的分析可能有遗漏）。

变更概览：
- paper.tex: 新增稳健性检验小节，约 80 行
- analysis.R: 修改控制变量设定
- data.csv: 删除 12 个异常值观测

目标版本: "feat: 添加缺失值填充，附带异常值检测" (b2c3d4e)

方式选择：
1. 软回滚（保留修改到工作区，你可以选择性恢复）
2. 硬回滚（完全丢弃，干净利落）
3. 创建回滚记录（保留历史，未来可以查看为什么撤销）

User: 方式 3

Claude: ✅ 已创建回滚记录！
新存档备注: "revert: 撤销控制变量修改（回归结果异常）"
存档编号: d4e5f6g

你的分析回到了上一个稳定状态。
被撤销的修改保存在历史中，随时可以查看。

这就是 Git 真正的价值：试错零成本。 你可以大胆让 AI 实验各种方法，不行了随时回到之前的状态。这条「安全网」是你在 AI 时代做科研的基本装备。

进阶：分支管理和合作者协作

上面三个场景覆盖了个人日常使用。当你需要更复杂的操作时，CC 同样能帮你搞定。这里只做简要说明，需要时直接对 CC 描述需求即可：

中英文版本并行：对 CC 说「Git 创建一个英文版分支，基于当前版本但独立修改」。CC 会创建两条互不干扰的时间线——中文投稿版和英文投稿版各自独立演进。

与合作者同步：对 CC 说「Git 拉取合作者的最新修改，看看有没有冲突」。CC 会自动检测你和 co-author 同时修改了哪些文件，标记出冲突部分并提供合并选项。不需要手动逐行对比代码。

小提示：这两个功能在日常科研中使用频率较低，知道「CC 能搞定」就够了。当你需要的时候，回到这篇文章查一下，或者直接跟 CC 描述你的需求。

最佳实践：养成「对话式存档」习惯

常用口头禅速查

• 完成一段数据分析 → 「Git 保存当前进度」
• 跑完一组回归 → 「Git 存档，备注：完成基准回归」
• 修改论文结构 → 「Git 保存，这是论文结构调整」
• 实验性修改（不确定对不对）→ 「Git 创建实验分支，试试新模型」
• 发现之前的分析更好 → 「Git 回滚到上上次存档」
• 准备投稿 → 「Git 创建投稿分支，冻结当前版本」
• 查看历史 → 「显示所有 Git 存档记录」

存档频率建议

• 数据处理阶段：每完成一个清洗步骤就存档（去重 → 存档 → 缺失值处理 → 存档 → 标准化 → 存档）
• 实证分析阶段：每跑完一组回归就存档（基准 → 存档 → 稳健性1 → 存档 → 稳健性2 → 存档）
• 论文写作阶段：每完成一个章节就存档（引言 → 存档 → 文献综述 → 存档 → 实证 → 存档）

原则：存档的成本是 5 秒钟说一句话，不存档的成本是丢失半天工作。

好备注 vs 坏备注

好的备注让你三个月后还能看懂这次修改的目的：

❌ 差备注: "修改代码"
✅ 好备注: "fix: 修正控制变量的滞后阶数（从 t-1 改为 t-2）"

❌ 差备注: "更新论文"
✅ 好备注: "feat: 添加稳健性检验（替换被解释变量度量方式）"

❌ 差备注: "试一下"
✅ 好备注: "exp: 实验 Probit 模型（当前 Logit 结果不显著）"

CC 会自动生成规范备注，但你可以随时要求修改——就像场景一里展示的那样。

CC 不完美的时候

诚实地说，CC 有时候会理解错你的意思，有时候生成的备注不够精准，有时候操作需要你确认两三次才能对。这不是 bug，是 AI 辅助工作的正常状态。

但关键是：正因为有 Git 的存档机制，CC 的任何操作都是可逆的。说错了话 → 纠正 → 重来。最坏的情况也就是回到 10 分钟前的存档。

Git 给了你「不怕犯错」的底气。 这也是为什么 Git 和 AI 协作是天作之合——AI 帮你加速，Git 帮你兜底。

常见问题速查

Q: 我完全不懂 Git，能直接用吗？

能。本文从头到尾你看到的都是自然语言对话，没有一行命令需要你记住。CC 负责翻译你的需求为 Git 操作。

Q: CC 操作错了怎么办？

Git 的核心设计就是「可逆」。任何操作都可以撤销。只要养成频繁存档的习惯，最坏的情况就是回到 10 分钟前的状态。

Q: 我的数据文件很大（几百 MB），Git 能处理吗？

告诉 CC「启用 Git LFS 管理大文件」，它会自动配置。大文件会被替换为轻量指针，实际内容存储在独立空间中，不会拖慢你的仓库。

Q: 敏感数据不小心存档了，怎么彻底删除？

告诉 CC「用 Git 移除敏感数据并清理历史」，它会使用专业工具帮你彻底删除，包括历史版本中的痕迹。

Q: 我用 Overleaf 写论文，还需要 Git 吗？

Overleaf 自带版本历史，但功能较简单。如果你需要复杂的分支管理（中文/英文版并行）、和代码仓库联动、或者详细的修改备注——Git 更强大。两者可以结合使用：Git 管理本地项目，Overleaf 作为协作平台。

Q: 我的合作者不用 Git，怎么办？

这个很常见。如果合作者习惯用微信或坚果云发文件，你照样可以把收到的文件放进你的 Git 项目中存档。至少你自己这一侧的历史是完整的。等合作者看到你能随时回到任何版本，说不定也会感兴趣。

总结：AI 时代的科研存档工作流

• 以前手动复制 paper_v1_v2_v3.tex，现在「Git 保存当前版本」，自动存档 + 规范备注
• 以前忘记昨天改了什么，现在「显示最近 Git 修改」，CC 告诉你改了哪些文件
• 以前导师说「回到上周那版」很头疼，现在「Git 回滚到某天的存档」，一键恢复
• 以前英文版和中文版互相覆盖，现在 Git 创建分支，两条独立时间线
• 以前 co-author 的修改冲突全靠肉眼比对，现在 CC 自动检测 Git 冲突并帮你合并
• 以前写修改说明花 10 分钟，现在 CC 自动生成规范 Git 备注

核心心法：

• Git 是你的「科研时光机」——记录每一步，随时可回溯
• CC 是你的「智能操作员」——你只管说话，它负责执行
• 你只管做科研决策——「保存」「回滚」「试试新方法」

开始你的第一次「智能存档」

打开 Claude Code，进入你的项目文件夹：

1. 说：「帮我把这个项目用 Git 管理起来，保存当前状态。」
2. 开始正常干活。
3. 每次想存档时说：「Git 保存当前进度。」

五分钟之后，你就有了第一个科研项目的完整版本历史。

AI 时代的科研版本管理，不需要你学任何命令，只需要养成一个习惯：改完就存档，一句话的事。

本文面向 Git 零基础科研工作者编写。核心思路：用自然语言对话替代命令行操作，让版本管理零门槛。

推荐阅读：

• Git 飞行规则（中文） — 遇到问题时的速查手册
• Claude Code 官方文档

如果这篇文章对你有帮助，欢迎转发给和你一样「不想学命令行但需要管版本」的同事和同学。