Git：AI 写代码时代，为什么还要懂一点？

arlionn

97人浏览 · 2026-06-13 09:00:00

arlionn · 2026-06-13 09:00:00 发布

温馨提示：若页面不能正常显示数学公式和代码，请阅读原文获得更好的阅读体验。

作者： 丁闪闪 (连享会)
邮箱： lianxhcn@163.com

Title: Git：AI 写代码时代，为什么还要懂一点？
Keywords: github, 版本控制, 代码审查, 代码管理, AI 协作

🍎 系列推文：AI 写代码时代，为什么还要懂一点？

编者按： 让 AI 写代码以后，一个新问题很快会出现：它不只是改一行代码，而是可能一次改掉十几个文件。它会重命名变量，调整路径，新增函数，删除临时文件，重写 README，顺手把结果表输出方式也换掉。代码可能确实更整洁了，但你也可能不知道它到底改了什么，更不知道改坏以后怎么退回去。Git 解决的不是“怎么写代码”，而是“怎么记录、比较、回退和协作”。本文不是 Git 入门教程，而是一份面向 AI 协作场景的 Git 使用手册。懂一点 Git，不是为了变成程序员，而是为了在 AI 修改项目之后，研究者仍然知道：它改了什么，为什么改，哪里可能出错，必要时如何回到上一个能跑通的版本。

参考资料：

Scott Chacon & Ben Straub, Pro Git.
Git 官方网站.
GitHub 官方网站.
GitHub Docs, Creating a pull request.
GitHub Docs, Reviewing changes in pull requests.
GitHub Docs, About pull requests.
连享会, GitHub Desktop 使用方法介绍：可视化 Git 管理的效率工具.
连享会, Stata 与 Github 交互.
连享会, 社会科学研究复现包中的自述文档模板.
连享会, 如何整理一份规范的论文复现文档？.
连享会, 代码审计：如何从源头确保你的论文可复现？.

1. AI 改了什么，你知道吗？

以前写论文代码，很多人用文件名管理版本：

main.do
main-修改版.do
main-最终版.do
main-最终版2.do
main-真的最终版.do
main-投稿版.do

这套方法虽然土，但还能勉强看出一点修改顺序。AI 介入以后，这个方法很快失效。因为 AI 不一定只改一个文件，它可能同时改：

01_clean_data.do
02_merge_policy.do
03_construct_variables.do
04_regression.do
tables.do
README.md
requirements.txt

或者在 R / Python 项目里同时改：

clean_data.R
model.R
plot.R
report.qmd
utils.py
README.md

这时，单靠文件名已经无法回答几个基本问题：

AI 到底改了哪些文件？
每个文件改了哪些行？
哪些修改是必要的，哪些是顺手改的？
结果变了，是因为模型改了，还是样本处理改了？
如果新版本跑不通，能不能退回上一个能跑通的版本？

Git 的价值就在这里。它不是替你写代码，而是记录项目变化。你可以把每一次重要修改保存成一个节点。以后项目出错时，不必凭记忆猜“昨天到底改了哪里”，而是可以直接查看差异，必要时回退。

所以，AI 时代学 Git 的目标不必设得很高。多数经管社科研究者不需要一开始就掌握复杂分支、rebase、cherry-pick 或 GitHub Actions。比较现实的目标是：

能记录一个能跑通的版本，能查看 AI 改了什么，能撤回错误修改，能把项目同步到 GitHub，能和合作者在同一个项目上有序协作。

这已经足够改变研究项目的管理方式。

2. Git 不是 GitHub

很多初学者会把 Git 和 GitHub 混在一起。二者相关，但不是一回事。

Git 是版本控制工具，记录本地项目的修改历史。GitHub 是代码托管和协作平台，可以把 Git 项目放到网上，方便备份、共享、协作和代码审查。

可以这样理解：

Git      = 本地版本控制
GitHub   = 远程托管和协作平台
GitHub Desktop = 可视化 Git 客户端

你完全可以只在本地使用 Git，不把项目传到 GitHub。对于含有敏感数据、未公开论文、保密项目的研究，先在本地使用 Git 记录版本，已经很有价值。

如果项目需要和学生、合作者或助研协作，可以再考虑 GitHub。GitHub 的好处是：

可以远程备份；
可以多人协作；
可以用 issue 记录任务；
可以用 pull request 审查修改；
可以在线查看每次修改的 diff；
可以发布公开复现包、课程材料或在线书。

如果不想一开始使用命令行，可以从 GitHub Desktop 这样的可视化工具入手。连享会此前已经介绍过 GitHub Desktop 使用方法介绍：可视化 Git 管理的效率工具和 Stata 与 Github 交互，可以作为延伸阅读。

但无论使用命令行、GitHub Desktop、VS Code，还是 Cursor、Claude Code、Codex 这类 AI 编程工具，背后的逻辑都是一样的：

Git 记录修改，GitHub 管理协作。

3. 先把项目纳入版本控制

一个研究项目在使用 Git 前，最好先有基本目录结构。例如：

my_project/
├── data_raw/        原始数据
├── data_clean/      清洗后的数据
├── code/            R、Python、Stata 代码
├── output/
│   ├── tables/      表格
│   └── figures/     图形
├── docs/            论文、讲义、说明文档
├── README.md
└── .gitignore

所谓“项目根目录”，就是项目最外层文件夹。上面这个例子中，data_raw/、code/、output/、README.md 和 .gitignore 所在的这一层，就是项目根目录。