让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:两个任务怎样避免改乱同一份文件”。