Git版本控制与团队协作规范指南

2022年6月18日 · 阅读约需14分钟

前言

Git是现代软件开发中不可或缺的版本控制工具。良好的Git使用规范和协作流程，能够显著提升团队开发效率，减少代码冲突，保证代码质量。本文将分享一套完整的Git工作流和团队协作规范。

一、Git基础配置

1.1 用户信息配置

# 全局配置
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

# 查看配置
git config --list

1.2 常用别名配置

git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"

二、分支管理策略

2.1 Git Flow工作流

主要分支：

master/main：生产环境代码，随时可发布
develop：开发分支，最新开发成果

辅助分支：

**feature/***：功能分支，从develop创建
**release/***：发布分支，从develop创建
**hotfix/***：热修复分支，从master创建

2.2 分支命名规范

feature/xxx-功能描述
bugfix/xxx-问题描述
hotfix/xxx-紧急修复
release/vx.x.x

示例：

feature/user-login-module
bugfix/payment-timeout-issue
hotfix/security-patch
release/v1.2.0

2.3 分支操作流程

# 创建功能分支
git checkout develop
git pull origin develop
git checkout -b feature/new-feature

# 开发完成后合并
git checkout develop
git merge --no-ff feature/new-feature
git push origin develop

# 删除功能分支
git branch -d feature/new-feature
git push origin --delete feature/new-feature

三、提交规范

3.1 Commit Message格式


<type>(<scope>): <subject>

<body>

<footer>

3.2 Type类型说明

类型	说明
feat	新功能
fix	修复bug
docs	文档更新
style	代码格式调整
refactor	重构
perf	性能优化
test	测试相关
chore	构建/工具/依赖

3.3 优秀提交示例

# 好的提交
feat(auth): add JWT token authentication

- implement token generation and validation
- add refresh token mechanism
- update API documentation

# 不好的提交
git commit -m "update"
git commit -m "fix bug"
git commit -m "各种修改"

3.4 提交原则

原子提交：一个提交只做一件事
频繁提交：小步提交，便于回滚
描述清晰：他人能看懂做了什么
关联Issue：Closes #123

四、代码合并规范

4.1 Merge vs Rebase

使用Merge：

合并公共分支
保留完整历史

使用Rebase：

同步上游更新
保持提交历史线性
清理自己的提交记录

# 同步develop分支更新
git checkout feature/my-feature
git rebase develop

# 解决冲突后
git add .
git rebase --continue

4.2 Pull Request流程

创建PR：功能分支 → 目标分支
Code Review：至少1人审核通过
CI检查：自动化测试通过
合并代码：Squash Merge或Rebase
删除分支：合并后清理分支

4.3 Code Review要点

✅ 代码逻辑正确
✅ 符合编码规范
✅ 有必要的注释
✅ 包含单元测试
✅ 没有明显的性能问题
✅ 安全漏洞检查

五、常用Git命令

5.1 日常操作

# 查看状态
git status

# 查看差异
git diff
git diff --cached

# 暂存和提交
git add .
git add -p  # 交互式暂存
git commit -m "message"

# 撤销操作
git checkout -- file  # 撤销工作区修改
git reset HEAD file    # 撤销暂存
git commit --amend     # 修改最后一次提交

5.2 暂存功能

# 暂存当前工作
git stash
git stash save "message"

# 查看暂存列表
git stash list

# 恢复暂存
git stash apply
git stash pop  # 恢复并删除

# 删除暂存
git stash drop
git stash clear

5.3 历史查看

# 查看提交历史
git log
git log --oneline
git log --graph
git log -p  # 显示差异

# 搜索提交
git log --grep="keyword"
git log --author="name"

六、团队协作规范

6.1 每日工作流程

开始工作前：拉取最新代码

git checkout develop
git pull origin develop

创建分支：基于最新develop创建功能分支
开发过程：频繁提交，定期同步
完成功能：自测通过后提PR
Code Review：根据反馈修改
合并上线：合并后删除分支

6.2 冲突解决

预防冲突：

频繁同步主干
模块化开发
沟通并行开发内容

解决冲突步骤：

保持冷静，不要慌张
理解冲突产生的原因
与相关开发人员沟通
手动合并代码
测试验证后提交

6.3 版本发布规范

# 创建发布分支
git checkout develop
git checkout -b release/v1.0.0

# 修复bug，更新版本号
# 测试通过后合并
git checkout master
git merge --no-ff release/v1.0.0
git tag -a v1.0.0 -m "Release v1.0.0"

git checkout develop
git merge --no-ff release/v1.0.0

git branch -d release/v1.0.0

七、常见问题与解决方案

7.1 误操作恢复

# 找回删除的分支
git reflog
git checkout -b branch-name <commit-hash>

# 恢复错误的reset
git reset HEAD@{1}

7.2 大文件处理

使用Git LFS管理大文件
避免提交二进制文件
配置.gitignore

7.3 仓库清理

# 清理已合并的分支
git branch --merged | grep -v "\*" | xargs -n 1 git branch -d

# 清理远程已删除的分支引用
git remote prune origin

八、Git规范检查清单

✅ 每个功能在独立分支开发 ✅ Commit Message符合规范 ✅ 提交前自测通过 ✅ 代码经过Code Review ✅ CI自动化检查通过 ✅ 定期同步主干分支 ✅ 合并后及时清理分支 ✅ 敏感信息不提交到Git

结语

规范的Git使用是团队协作的基础。没有完美的工作流，只有适合团队的工作流。建议团队根据实际情况制定规范，并严格执行。工具是辅助，良好的沟通和协作习惯才是高效开发的关键。

记住：Git的真正价值不在于版本控制本身，而在于它如何改变团队协作的方式。