版本控制与协作 / 系统课时

完成团队协作综合实践

完成团队协作综合实践

学习目标

完成本课后,你将能够:

  • 串联克隆、分支、提交、同步与合并流程
  • 在主线变化后变基功能分支
  • 完成标签发布并验证远程结果

问题背景或应用场景

单个命令只有放入完整流程才具有工程价值。本课使用本地裸仓库模拟远程服务,由维护者和开发者两个工作区完成并行开发、同步、合并和发布,覆盖课程核心操作。

核心原理

综合流程强调三条主线:本地主分支保持与远程主线同步;业务修改只在功能分支完成;发布标签只指向已经合并并验证的主线提交。主线并行变化时,功能分支先获取并变基,可以提前处理兼容问题。

真实托管平台还会加入拉取请求、代码评审、CI、分支保护和权限控制。本地模拟无法替代这些服务,但可以准确演示 Git 对象、引用和历史整合过程。

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=enabled

Tips

  • 每个阶段都检查当前分支和工作区。
  • 功能分支提交保持小而完整。
  • 发布前从标签对应提交执行最终验证。

常见错误

1. 在开发分支直接打发布标签

  • 错误表现:标签不在主线已评审提交上。
  • 产生原因:跳过合并与发布验证。
  • 正确处理:先合并主线、运行检查,再从主线创建标签。
  • 修复结果:版本对应正式发布历史。

2. 同步主线后不重新测试

  • 错误表现:变基成功但组合行为异常。
  • 产生原因:只验证 Git 操作,没有验证项目。
  • 正确处理:在新基线上执行完整测试。
  • 修复结果:发布结果满足功能与工程验收。

本课练习

1. 复现完整协作流程

  • 任务目标:串联全部步骤。
  • 输入或初始条件:使用本地裸仓库模拟远程。
  • 实现要求:由两个工作区完成开发和发布。
  • 验收条件:远程主线包含功能且存在版本标签。

2. 加入冲突处理

  • 任务目标:提高综合难度。
  • 输入或初始条件:让主线和功能分支修改同一文件。
  • 实现要求:变基时解决冲突并继续。
  • 验收条件:最终历史线性且文件业务正确。

3. 加入发布修复

  • 任务目标:模拟补丁版本。
  • 输入或初始条件:v1.0.0 发布后发现小问题。
  • 实现要求:创建修复分支、合并并发布 v1.0.1。
  • 验收条件:两个标签分别指向正确提交。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

完成团队协作综合实践

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通