拉取请求建议将代码更改从一个分支合并到另一个分支。 作为一种协作功能,拉取请求为你提供了一个在相关工作成为项目一部分之前对其进行讨论和审查的空间。
为何使用拉取请求
拉取请求会将一组代码更改转换为对话。 你不是直接合并这些工作内容,而是先提出它们,让协作者发表意见。 这有助于你和你的团队以多种方式维护高质量且安全的代码:
- 在 bug 和问题进入主分支之前及早发现它们。
- 通过与特定行相关的反馈,共同讨论和改进更改。
- 保持一个清晰、可查看的更改历史记录以及原因。
使用拉取请求可以执行的操作
拉取请求使更改易于查看和验证。 通过拉取请求,您可以:
- 从分支或复刻中提出更改。
- 逐行讨论并审查所提议的更改。
- 针对更改运行自动检查,例如测试、生成和代码扫描。
- 回应反馈,并随着拉取请求的演进不断更新它。
- 在评审通过且所需检查均已通过后,合并更改。
拉取请求的关键部分
拉取请求将你和审阅者需要的所有内容收集到一个位置:
- 会话 显示说明、评论、审核以及活动时间线。
- 提交记录 显示该分支随时间推移的变化情况。
- 检查 显示自动测试、生成和其他验证的结果。
- 文件更改 显示审阅者评论的差异。
- 合并框会显示你能否合并你的更改。 它会显示在拉取请求合并前仍需完成哪些事项,例如必需的审查或检查。
拉取请求如何融入你的工作流
无论是建议更改还是查看其他人的更改,拉取请求都遵循几个阶段:
- 为该仓库创建分支或派生副本,以创建一个隔离的工作环境。
- 提交你的更改,并在进行过程中逐步建立你的工作历史记录。
- 创建拉取请求,提议将您的更改合并到基础分支。
- 查看并讨论 与协作者所做的更改,根据需要进行更新。
- 准备就绪后合并 拉取请求。