版本控制与协作 / 系统课时
完成团队协作综合实践
完成团队协作综合实践
学习目标
完成本课后,你将能够:
- 串联克隆、分支、提交、同步与合并流程
- 在主线变化后变基功能分支
- 完成标签发布并验证远程结果
问题背景或应用场景
单个命令只有放入完整流程才具有工程价值。本课使用本地裸仓库模拟远程服务,由维护者和开发者两个工作区完成并行开发、同步、合并和发布,覆盖课程核心操作。
核心原理
综合流程强调三条主线:本地主分支保持与远程主线同步;业务修改只在功能分支完成;发布标签只指向已经合并并验证的主线提交。主线并行变化时,功能分支先获取并变基,可以提前处理兼容问题。
真实托管平台还会加入拉取请求、代码评审、CI、分支保护和权限控制。本地模拟无法替代这些服务,但可以准确演示 Git 对象、引用和历史整合过程。

基础用法
按“克隆 → 更新主线 → 创建分支 → 小步提交 → 获取主线 → 变基 → 推送功能分支 → 评审合并 → 打标签 → 推送标签”的顺序完成。每个关键节点都用状态和日志验证。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-team-project-demo
mkdir git-team-project-demo
cd git-team-project-demo
git init -q --bare remote.git
git init -q -b main maintainer
git -C maintainer config user.name "Maintainer"
git -C maintainer config user.email "maintainer@example.com"
printf "name=anystack-demo
" > maintainer/app.conf
git -C maintainer add app.conf
git -C maintainer commit -q -m "feat: initialize project"
git -C maintainer remote add origin ../remote.git
git -C maintainer push -q -u origin main
git -C remote.git symbolic-ref HEAD refs/heads/main
git clone -q remote.git developer
git -C developer config user.name "Developer"
git -C developer config user.email "developer@example.com"
git -C developer switch -q -c feature/health-check
printf "status=ok
" > developer/health.txt
git -C developer add health.txt
git -C developer commit -q -m "feat: add health status"
printf "check=enabled
" >> developer/health.txt
git -C developer add health.txt
git -C developer commit -q -m "test: enable health check"
printf "release-ready=true
" >> maintainer/app.conf
git -C maintainer add app.conf
git -C maintainer commit -q -m "chore: prepare release"
git -C maintainer push -q
git -C developer fetch -q origin
git -C developer rebase -q origin/main
git -C developer push -q -u origin feature/health-check
git -C maintainer fetch -q origin
git -C maintainer merge -q --no-ff origin/feature/health-check -m "merge: health check feature"
git -C maintainer tag -a v1.0.0 -m "release: v1.0.0"
git -C maintainer push -q origin main v1.0.0
printf "remote-branches:
"
git --git-dir=remote.git for-each-ref --format='%(refname:short)' refs/heads | sort
printf "remote-tags:
"
git --git-dir=remote.git tag --list
printf "release-file:
"
git --git-dir=remote.git show v1.0.0:health.txt预期输出
text
remote-branches:
feature/health-check
main
remote-tags:
v1.0.0
release-file:
status=ok
check=enabledTips
- 每个阶段都检查当前分支和工作区。
- 功能分支提交保持小而完整。
- 发布前从标签对应提交执行最终验证。
常见错误
1. 在开发分支直接打发布标签
- 错误表现:标签不在主线已评审提交上。
- 产生原因:跳过合并与发布验证。
- 正确处理:先合并主线、运行检查,再从主线创建标签。
- 修复结果:版本对应正式发布历史。
2. 同步主线后不重新测试
- 错误表现:变基成功但组合行为异常。
- 产生原因:只验证 Git 操作,没有验证项目。
- 正确处理:在新基线上执行完整测试。
- 修复结果:发布结果满足功能与工程验收。
本课练习
1. 复现完整协作流程
- 任务目标:串联全部步骤。
- 输入或初始条件:使用本地裸仓库模拟远程。
- 实现要求:由两个工作区完成开发和发布。
- 验收条件:远程主线包含功能且存在版本标签。
2. 加入冲突处理
- 任务目标:提高综合难度。
- 输入或初始条件:让主线和功能分支修改同一文件。
- 实现要求:变基时解决冲突并继续。
- 验收条件:最终历史线性且文件业务正确。
3. 加入发布修复
- 任务目标:模拟补丁版本。
- 输入或初始条件:v1.0.0 发布后发现小问题。
- 实现要求:创建修复分支、合并并发布 v1.0.1。
- 验收条件:两个标签分别指向正确提交。
按自己的节奏,确认真正理解。