代码管理:Git 与 GitHub

用 Codex 做真实项目,迟早要和 Git、GitHub 打交道。一句话拆清楚三者关系:Git 记录本地代码变化,GitHub 远程保存与协作,Codex 完成具体的编程任务。 懂这套组合,改错能回退,实验能隔离,协作能走 PR。

#Git vs GitHub

#必懂 Git 概念

#必懂 GitHub 概念

#为什么用 Codex 更需要 Git

Codex 每次任务可能改动大量文件。没有版本控制,出错很难回头;有了 Git:

• 可审查:Codex 改完用 git diff 看到底动了哪里
• 可回退:改坏了,找到上一个好的 commit 恢复
• 可分阶段:多步改动每步 commit,进度清晰
• 可隔离实验:用 branch 或 worktree 让 Codex 大胆试,主线不受影响
• 可协作:push 到 GitHub,走 PR / review / merge 流程

#在 Codex 里用 Git 的标准流程

1

初始化仓库

在项目根目录运行 git init,把项目纳入版本控制。

2

写好 .gitignore

告诉 Codex:"帮我写一份 .gitignore,排除 node_modules、.env 和其他不需要追踪的文件。"它会根据技术栈生成合适的清单。

3

首次 commit

在 Codex 动任何东西之前,先保存一个干净的初始版本:git add -A && git commit -m "init"。

4

新建任务分支

每个任务单独开分支,比如 git checkout -b feat/add-login。这样即便 Codex 改坏,主线也不受影响。

5

让 Codex 实现需求

在对话框描述目标,让它读代码、写代码、跑命令。

6

查看 diff

Codex 完成后,在终端运行 git diff 或在 IDE 里查看改动,确认符合预期。

7

运行验证

跑测试或启动项目确认功能正常,有问题继续让 Codex 修。

8

Commit 保存

满意后:git add -A && git commit -m "feat: 描述这次改动"。

9

Push 到 GitHub

git push origin feat/add-login,把分支推到远端备份。

10

创建 PR

在 GitHub 上从功能分支发起 Pull Request,review 通过后合入主线。

#上传到 GitHub 的前提

把仓库地址发给 Codex,告诉它:"把当前项目推到这个 GitHub 仓库",它会处理 remote add 和首次 push。

#代码回滚

#Git Worktree:给 Codex 开独立草稿本

普通分支切换时,整个工作目录会跟着变。Worktree 让你在同一个 Git 仓库里同时维护多个独立的工作目录——相当于给项目开了几个互不干扰的草稿本。

#为什么需要 Worktree

#基本用法

# 在主仓库旁边创建一个新的工作副本,关联到新分支
git worktree add ../my-project-experiment feat/experiment

# 查看当前所有 worktree
git worktree list

# 实验完毕,合并分支后删除 worktree
git worktree remove ../my-project-experiment
git branch -d feat/experiment

典型流程:在主目录正常工作 → 开新 worktree 交给 Codex 实验 → Codex 改好后 git diff 审查 → 满意就合并回主线,不满意直接 git worktree remove 扔掉,主项目分毫未动。