Codex 从零到能交付(17):Git 分支:给一次改动安排独立的工作位置

0 阅读6分钟

让Codex改完代码,发现不满意,再凭记忆改回去,很容易漏掉一行。Git分支能把一次尝试和它的提交记录命名保存,但它不会给同一目录变出两套同时独立的文件。

这一篇沿用资料整理助手,只把摘要标题从“文件清单摘要”改成“资料清单摘要”,用一个新建的合成练习仓库走完分支与提交过程。

创作说明:AI 辅助创作。

目标与前置条件

需要可用的Git、Python和前篇练习文件。目标是分清工作区、暂存区、提交与分支,保存一次可以解释、可以核对的最小改动。

请在新的练习副本操作,不要直接套在已有业务仓库里。副本只包含两个脚本、合成input和.gitignore,没有真实客户资料、密钥或远程仓库。本次确实建立并运行了这个本地Git练习;没有推送、合并或修改全局配置。

第一步:先确认位置和当前状态

对已经存在的仓库,先运行:

git rev-parse --show-toplevel
git status --short --branch
git branch --show-current

看到已有未提交改动时,先辨认它们是谁的、是否属于本次任务。不要为了“清爽”就删除、覆盖、重置或自动提交。分支也不能自动替你保存未提交内容。

对本篇全新的合成副本,我们先初始化main,并建立基线提交。把output/与__pycache__/写入.gitignore,然后只添加明确的练习文件:

git init -b main
git add .gitignore file_list.py summarize_list.py input
git commit -m "Baseline synthetic file assistant"
git status --short --branch

这里假定Git的提交身份已经按你的环境配置好;若提示缺少身份,先使用自己的适当信息配置本仓库,不要照抄别人的身份。本次合成练习使用了明确的教学身份,没有将它写入全局配置,也没有把它当成用户的真实署名。

.gitignore只影响未跟踪文件是否被默认添加,不是保密机制,也不会自动移除已经被Git跟踪的文件。每次仍要审阅暂存内容。

第二步:创建分支,再提出小任务

在干净基线上建立分支:

git switch -c codex/chapter17-summary-title
git branch --show-current

官方Git资料介绍了创建分支并切换后,把后续提交记录在该分支上的流程;切换前还需处理可能冲突的未提交内容。Git分支基础

接下来给Codex一张具体任务卡:

先确认当前仓库根目录、分支及未提交状态。
本次只把summarize_list.py生成的Markdown标题
从“文件清单摘要”改为“资料清单摘要”。
文件数、总字节数、CSV输入规则和输入文件都不改变。
修改后展示差异并运行相关命令,先不要提交、推送或合并。
遇到已有其他改动,保留并单独说明,不自动清理。

本次实际只改了报告字符串中的标题。你不必为了展示分支功能而增加大功能,也不必让模型同时重写两个脚本。

第三步:先审阅和运行,再暂存

在练习仓库中核对:

git diff -- summarize_list.py
python -I -B -X utf8 file_list.py
python -I -B -X utf8 summarize_list.py

本次两条业务命令退出0,报告为:

# 资料清单摘要

文件数:2
总字节数:5

虽然输入中还有一份c.md,默认清单只统计两份.txt,因此仍是2个文件、5字节。核对目标是标题改变、统计不变,而不是看见退出0就认为任何改动都正确。

确认后,明确暂存目标文件,再看一次将要进入提交的差异:

git add summarize_list.py
git diff --cached -- summarize_list.py
git status --short
git commit -m "Clarify synthetic summary title"
git log --oneline -2

git diff检查尚未暂存的修改;暂存后要用git diff --cached核对准备提交的内容。不要因为前者暂时没有输出,就误以为暂存区也没有修改。

第四步:验证分支保存的到底是什么

本次创建了两个不同的提交:基线9347fffa,功能提交6366776e。你的哈希会不同,不需要抄这个值;应记录自己的结果。

提交后工作区干净,我们切回main检查摘要脚本,旧标题确实恢复;切回功能分支,新标题再次出现。检查的是脚本内容和分支对应的提交,不只是终端里的分支名称。

位置本次核对结果
main仍指向基线提交,脚本保留“文件清单摘要”
codex/chapter17-summary-title包含功能提交,脚本使用“资料清单摘要”
最终工作区没有未提交的受跟踪文件改动

还有一个容易误会的细节:output/summary.md被忽略,没有进入提交。切分支时它不会自动变成对应版本的报告。要验证当前分支的运行结果,需要重新运行当前脚本;不要拿残留报告证明分支代码已经执行。

这也解释了分支的边界:它组织提交历史,同一工作目录仍只有一套当前检出的文件。两项任务需要同时打开不同版本时,要使用后篇介绍的独立工作目录方法,不能让两个任务反复切同一个目录的分支。

验收与常见错误

完成本篇,应交出基线和功能提交、准确分支名、目标文件差异、业务运行结果以及最终状态。没有推送就写“本地已提交”,不要写成“GitHub已备份”或“线上已发布”。本次没有远程操作,也没有合并回主分支。

常见错误包括:创建分支前不检查已有改动;把暂存当成提交;把提交当成测试通过;把本地提交当成远程备份;以为忽略的输出也会随分支恢复。Git记录与业务验收各回答一个问题,二者都要检查。

资料与实作日期:2026年11月17日。新合成仓库的初始化、分支、差异、两条业务命令、提交与来回切换已实测;未修改现有业务仓库,未进行远程推送、多人协作或合并冲突测试。

前篇:第16篇“在IDE里用Codex”。后篇:第18篇“Worktree:两个任务怎样避免改乱同一份文件”。