版本控制与协作 / 系统课时
建立基础团队协作规范
建立基础团队协作规范
学习目标
完成本课后,你将能够:
- 设计主分支与功能分支职责
- 约定提交粒度和评审流程
- 选择一致的合并与历史策略
问题背景或应用场景
命令熟练并不等于协作高效。若团队成员使用不同分支命名、随意改写共享历史、混合无关提交,仓库仍会难以维护。基础规范的目标是让每个人都能预测他人的操作。
核心原理
小型团队至少应明确:主分支保持可发布或可构建;开发通过短生命周期功能分支进行;提交保持单一目的;合并前完成评审和自动检查;共享分支禁止随意强制推送。
合并策略可以选择普通合并、压缩合并或变基后合并,但应统一。普通合并保留分支上下文,压缩合并让主线更简洁,变基强调线性历史。不存在适合所有团队的唯一答案,关键是与发布、回滚和审计需求一致。

基础用法
为项目写一份简短 CONTRIBUTING.md,包括分支命名、提交格式、拉取请求检查项和合并策略。通过服务器分支保护和 CI 把关键规则自动化,而不是只依赖口头提醒。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-team-rules-demo
mkdir git-team-rules-demo
cd git-team-rules-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "base
" > app.txt
git add app.txt
git commit -q -m "feat: add base"
git switch -q -c feature/user-profile
printf "profile model
" > profile.txt
git add profile.txt
git commit -q -m "feat: add profile model"
printf "profile validation
" >> profile.txt
git add profile.txt
git commit -q -m "test: add profile validation case"
printf "feature-commits: "
git rev-list --count main..feature/user-profile
printf "diff-check: "
if git diff --check main..feature/user-profile | grep -q .; then echo failed; else echo passed; fi
git switch -q main
git merge -q --no-ff feature/user-profile -m "merge: user profile feature"
printf "merge-subject: "
git log -1 --format=%s预期输出
text
feature-commits: 2
diff-check: passed
merge-subject: merge: user profile featureTips
- 规范越短越容易执行,优先覆盖高风险行为。
- 能自动检查的规则尽量交给 CI。
- 定期回顾规范是否仍符合团队规模和发布方式。
常见错误
1. 只规定分支名称
- 错误表现:历史仍然混乱且难以回滚。
- 产生原因:忽略提交粒度、评审和合并策略。
- 正确处理:补充从开发到合并的完整流程。
- 修复结果:团队操作结果更加一致。
2. 规则与工具不一致
- 错误表现:文档禁止直接推送,但服务器仍允许。
- 产生原因:缺少分支保护和自动检查。
- 正确处理:在托管平台配置保护规则与必需检查。
- 修复结果:关键规范得到技术约束。
本课练习
1. 编写协作清单
- 任务目标:把规则落地。
- 输入或初始条件:假设三人开发一个 Web 项目。
- 实现要求:写出不超过十条核心规范。
- 验收条件:覆盖分支、提交、评审和合并。
2. 比较合并策略
- 任务目标:理解取舍。
- 输入或初始条件:准备包含三个小提交的功能分支。
- 实现要求:分别模拟普通合并和压缩合并。
- 验收条件:能比较主线日志和回滚粒度。
3. 设计保护规则
- 任务目标:建立工程约束。
- 输入或初始条件:主分支用于生产发布。
- 实现要求:列出应启用的保护项。
- 验收条件:包含禁止直接推送、评审和 CI。
按自己的节奏,确认真正理解。