Best Practices

Git 最佳实践频道

把协作习惯拆成多个可独立阅读的专题,从提交质量、主题分支、同步策略,到共享历史边界与安全推送。

Best Practices

推荐学习顺序

先建立提交和分支习惯,再进入同步策略、共享历史边界与安全推送。

Best Practices

代表专题

先看提交质量、共享历史边界和安全推送,基本就能建立一套更稳的协作底线。

Best Practices

专题目录

把原来聚合在一篇文章里的协作建议拆成多个更容易复用和持续扩写的专题。

提交卫生与提交信息

把提交拆成逻辑独立的 changeset,并用可读的提交信息表达意图、动机和边界,让 review、revert 和 cherry-pick 都更轻。

主题分支策略

用 topic branch 隔离单项工作,让并行开发、回滚、rebase、review 和发布边界都更清楚。

分支策略与分支生命周期

把主线、发布线、修复线和主题分支的职责拆开,团队才更容易同时兼顾开发速度、评审质量和发布稳定性。

先 fetch 再同步

把观察远端状态和真正改写本地分支分开,避免把同步决策完全交给默认 pull 行为。

共享历史的改写边界

明确哪些历史可以放心整理,哪些历史应该默认视为共享并谨慎处理,避免 rebase、amend、reset 和 force push 伤到别人。

评审前整理与安全推送

在发起评审和推送之前,用一套轻量检查动作整理提交栈、确认差异范围,并优先采用更保守的推送方式。

原子提交专题

把一次提交收敛成单一逻辑变更,降低 review 和回滚成本。

小步提交与主题分支整洁度

把提交粒度和主题分支边界同时管住,review 会更快,rebase 更稳,回滚也会轻松很多。

分支命名约定专题

建立稳定的分支命名模式,提升协作、自动化和排错效率。

提交评审前准备专题

在发起评审前收敛提交、同步基线并清理噪音改动。

Pull Request 评审准备与协作规范

评审质量很大程度上取决于送审前有没有把变更范围、提交叙事、上下文说明和后续响应机制准备清楚。

冲突处理惯例专题

把冲突处理变成固定流程,减少临时操作带来的遗漏和误判。

发布前 Git 卫生专题

在发布前用一组 Git 检查动作降低标签、分支和版本记录出错概率。

安全使用 cherry-pick专题

在回移修复或选择性复用提交时,避免重复、漏拣和上下文错配。

小批量评审专题

用更小的提交批次和更短的生命周期换取更快的 review 节奏。

安全 force push 协议

需要重写历史时,用明确告警、冻结窗口和 `--force-with-lease` 协议降低误覆盖协作者提交的风险。

提交信息规范约定

统一提交信息结构(动词、范围、原因)提升日志可读性、问题追踪效率和跨团队协作透明度。

发布清单纪律

通过固定发布清单把关键检查项前置并标准化,降低“靠经验记忆”导致的线上发布遗漏与事故。

代码评审交接质量

通过高质量 review handoff(背景、范围、风险、验证)减少评审往返沟通成本并提升合并决策速度。

Git 别名与效率提升

高效 Git 别名配置、常用别名清单、Shell 别名、团队共享别名配置与最佳实践。

高级提交信息规范

Conventional Commits、语义化提交、Co-authored-by、Breaking Changes 等高级提交信息规范与工具支持。

Git 安全实践

敏感信息泄露处理、密钥管理、.env 安全、git-secrets、GPG 签名提交、SSH 密钥管理等安全实践。

标签与版本管理

使用语义化版本(SemVer)和带注释标签建立清晰、可追踪的版本发布规范。

二分友好的提交

保持每次提交独立可构建、可测试,让 git bisect 能高效定位引入问题的提交。

改写历史前备份

在执行 rebase、filter-repo 等改写历史操作前建立安全网,确保误操作后可恢复。