用途:为项目提供 Git 版本控制与协作开发的规范参考,适用于新项目搭建工作流、选择分支策略、撰写提交信息与 PR 描述、解决合并冲突、管理发布与版本标签,以及团队新人上手。
主要能力:
- 分支策略:GitHub Flow(main 始终可部署,功能分支经 PR 合并)、主干开发(短生命周期分支配合功能开关,CI 通过后合并)、GitFlow(main/develop/release/hotfix 多分支,适合计划性发布)。资料给出按团队规模与发布节奏的选择建议。
- 提交规范:Conventional Commits 格式 <type>(<scope>): <subject>,类型含 feat、fix、docs、style、refactor、test、chore、perf、ci、revert,并提供 .gitmessage 模板与启用命令 git config commit.template .gitmessage。
- merge 与 rebase:merge 保留完整历史,适合合并功能分支;rebase 生成线性历史,适合本地未推送分支更新。资料明确列出不应 rebase 的场景(已推送共享分支、他人基于其工作、受保护分支、已合并分支)。
- 冲突解决:使用 git merge --no-commit --no-ff 预检,git status 查看冲突文件,可手动编辑、git mergetool 或 git checkout --ours/--theirs 选择一侧,随后 git add 并提交。
- 分支管理与清理:命名约定(feature/、fix/、hotfix/、release/、experiment/、poc/),删除已合并本地分支、git fetch -p 清理远程引用、删除远程分支。
- 发布管理:语义化版本 MAJOR.MINOR.PATCH,创建与推送注解标签,用 git log 或 npx conventional-changelog 生成变更日志。
- 配置与别名:用户身份、默认分支、pull.rebase、push.default、diff.algorithm 等配置,以及 co、br、st、visual、undo 等别名示例。
- Git Hooks:pre-commit 运行 lint/测试并检测密钥,pre-push 运行完整测试并检查 console.log。
- 常见工作流与纠错:新功能开发、更新 PR、同步 fork、撤销提交(reset --soft/--hard、revert、amend)。
使用方式:按资料中的命令与模板在本地仓库或团队规范中落地,例如创建分支 git checkout -b feature/user-auth、rebase 更新 git rebase origin/main、推送标签 git push origin v1.2.0。
适用场景:SaaS 与 Web 应用、初创团队、高节奏团队、企业级与受监管行业的发布流程。
限制:资料未提供具体工具版本、平台差异、收费或效果数据;部分命令(如强制推送、reset --hard)具有破坏性,需谨慎使用。