版本控制与协作 / 系统课时
在分支上完成独立提交
在分支上完成独立提交
学习目标
完成本课后,你将能够:
- 在功能分支完成独立修改和提交
- 使用日志观察分支分叉
- 确认主分支不会自动获得功能提交
问题背景或应用场景
创建并切换分支只是准备工作,真正的隔离来自在该分支上创建独立提交。功能开发完成后,需要确认提交落在正确分支、主分支仍保持稳定,并通过分支图理解后续合并的输入。
核心原理
当前分支上的新提交只推动该分支指针。若主分支没有并行提交,功能分支会形成一条从主分支向前延伸的直线;若主分支也继续发展,两者会从公共祖先分叉。未合并前,主分支无法通过自身历史访问功能提交。
分支隔离并不自动保证质量。功能分支仍应保持小步提交、运行测试并及时同步基线。长期分支积累大量差异后,冲突和评审成本都会增加。
基础用法
在功能分支开始工作前使用 git branch --show-current 确认位置。修改、暂存、提交后运行 git log --oneline --graph --decorate --all 查看分支指针。切换回主分支检查文件,验证功能内容尚未进入主线。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-feature-commit-demo
mkdir git-feature-commit-demo
cd git-feature-commit-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "base\n" > app.txt
git add app.txt
git commit -q -m "chore: create base"
BASE=$(git branch --show-current)
git switch -q -c feature/search
printf "search enabled\n" > search.txt
git add search.txt
git commit -q -m "feat: add search marker"
printf "feature file exists: "
test -f search.txt && echo yes
git switch -q "$BASE"
printf "base file exists: "
test -f search.txt && echo yes || echo no
git log --oneline --decorate --all --graph预期输出
text
feature file exists: yes
base file exists: no
* <FEATURE_COMMIT_ID> (feature/search) feat: add search marker
* <BASE_COMMIT_ID> (HEAD -> <DEFAULT_BRANCH>) chore: create baseTips
- 提交前再次确认当前分支,尤其在终端长时间打开后。
- 功能分支保持单一目标并及时推送备份。
- 使用分支图判断提交落点,不只看文件是否存在。
常见错误
1. 误在主分支提交
- 错误表现:功能提交直接进入稳定分支。
- 正确处理:若尚未共享,可在该提交创建功能分支,再把主分支安全重置到基线。
2. 分支长期不更新
- 错误表现:合并时出现大量冲突。
- 正确处理:定期获取并整合主分支最新变化,保持差异可控。
本课练习
1. 完成独立提交
- 任务目标:完成独立提交。
- 输入或初始条件:从主分支创建功能分支。
- 实现要求:新增一个文件并提交。
- 验收条件:切回主分支后文件不存在。
2. 观察分叉
- 任务目标:观察分叉。
- 输入或初始条件:功能分支提交后,主分支也创建另一提交。
- 实现要求:查看 graph。
- 验收条件:图中两条历史从同一祖先分叉。
3. 验证提交归属
- 任务目标:验证提交归属。
- 输入或初始条件:准备多个分支。
- 实现要求:使用
git branch --contains <hash>查询。 - 验收条件:只显示包含目标提交的分支。
按自己的节奏,确认真正理解。