Git 的正确使用姿势与最佳实践 | 青训营X豆包MarsCode 技术训练营｜豆包MarsCode AI 刷题

Git 是当今最流行的分布式版本控制系统，适用于个人开发和团队协作。其强大的功能和灵活的分支管理使得代码管理更加高效。为了充分利用 Git 的优势，提高团队协作效率和代码质量，以下是关于 Git 使用的正确姿势与最佳实践。

以分支为核心的工作流
- 主分支（main 或 master）：仅存储稳定、可发布的代码。
- 功能分支（feature）：用于开发新功能。
- 修复分支（hotfix）：用于紧急修复生产环境问题。
- 开发分支（develop）：可作为所有新功能的集成分支。
提交小而频繁
- 每次提交（commit）应关注一个独立的更改，确保易于回滚和审查。
  
  类型包括 feat（新功能）、fix（修复）、docs（文档更新）等。
代码库保持干净
- 避免将大文件和临时文件纳入版本控制。
- 利用 .gitignore 文件忽略不必要的文件。

使用 Pull Request（PR）工作流
- 每个开发者从主分支拉取新分支完成开发后，通过 PR 合并代码。
- 在 PR 中进行代码审查，确保代码质量和一致性。
代码审查的重要性
- 在合并 PR 前，至少一位团队成员审查代码。
- 检查代码是否遵守编码规范、是否影响现有功能、是否存在潜在错误。
避免直接推送到主分支
- 所有更改都应经过分支开发和 PR 审查流程。
- 为主分支启用保护策略，避免直接推送。
同步更新主分支
- 定期将主分支的更改合并到功能分支，减少冲突风险。
- 在合并功能分支前，确保主分支已同步并无冲突。
命名规范
- 分支命名：feature/功能描述、fix/问题描述。
- 提交信息：首字母小写，动词使用现在时。

合理使用标签（Tag）
- 为每次发布创建标签（例如 v1.0.0），便于追踪版本。
- 使用语义化版本号（MAJOR.MINOR.PATCH）表示更新类型。
频繁备份和推送
- 避免长期停留在本地开发，定期推送分支到远程仓库。
- 利用 Git Hooks 或 CI 工具，确保每次提交符合团队规范。
解决冲突的策略
- 频繁同步远程分支，减少冲突发生的机会。
- 若发生冲突，先理清上下文，再有序解决，避免草率操作导致问题。
分支清理
- 功能分支完成后及时删除，保持仓库清晰。
- 定期清理已合并的分支。

配置 Git Hooks
Git Hooks 是 Git 提供的钩子机制，可在特定事件发生时执行脚本。例如：
- pre-commit：检查代码风格或运行测试。
- post-merge：更新依赖或执行编译。
集成 CI/CD 流程
- 通过 Jenkins、GitHub Actions 或 GitLab CI/CD 自动化构建和测试流程。
- 确保代码在每次提交或合并后能自动通过测试。
可视化工具
- 使用 Git 图形界面工具（如 Sourcetree、GitKraken）帮助团队更好地理解分支和历史。

Git 配置优化

设置全局用户名和邮箱：

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

误提交敏感信息
- 使用 git filter-repo 或 git rebase 清理历史记录。
- 添加敏感信息到 .gitignore，避免重复提交。
合并冲突
- 使用 git mergetool 辅助解决冲突。
- 合并冲突后，检查代码是否完整且功能正常。
回滚错误提交
- 撤销未推送的提交：
```
git reset --soft HEAD~1
```
- 回滚已推送的更改：
```
git revert <commit-id>
```

Git 是强大且灵活的版本控制工具，但只有掌握正确的使用姿势，才能在个人开发和团队协作中事半功倍。通过合理的分支管理、规范的提交习惯以及高效的协作流程，团队可以提高开发效率并保证代码质量。与此同时，善用工具和自动化流程，将繁琐的操作交给机器完成，开发者便能专注于创造高质量的软件。

Git 的正确使用姿势与最佳实践 | 青训营X豆包MarsCode 技术训练营 ｜ 豆包MarsCode AI 刷题