文章列表
1 分钟阅读

GitHub Pull Request 工作流入门


系列:版本控制基础

第 5 / 8 篇

  1. Git 安装与使用教程:Linux 和 Windows 从零开始版本管理
  2. Git 进阶:你迟早要会的几个救急命令
  3. Git 分支管理指南:main、dev、feature、release 怎么用
  4. Git Commit 规范:怎么写清楚提交信息
  5. GitHub Pull Request 工作流入门
  6. GitHub Actions 入门:为博客加自动检查
  7. Git 冲突解决指南:merge、rebase、cherry-pick 冲突怎么处理
  8. GitHub Actions 自动部署实战:从检查到发布的完整流程

Pull Request 不是 GitHub 的装饰功能,它是团队协作的基本单位:把一组改动拿出来,让别人看、测试、讨论,然后再合并。

基本流程

Terminal window
git switch -c feature/login
git add .
git commit -m "feat(auth): add login endpoint"
git push -u origin feature/login

然后在 GitHub 页面创建 PR,目标分支一般是 main

PR 描述写什么

至少写三件事:

## 变更
- 增加登录接口
- 增加 JWT 校验依赖
## 验证
- npm run test
## 风险
- 需要配置 SECRET_KEY

不要只写“如题”。

Review 怎么处理

别人评论后,按问题逐条改,再继续 push 到同一个分支。PR 会自动更新。

如果讨论结论不是改代码,也可以回复说明原因。

合并方式

小功能常用 squash merge,把多个零碎提交压成一个清楚的提交。大型分支可以 merge commit 保留历史。

常见问题

PR 里混进无关改动,通常是分支开错位置或功能做太大。先看 Git 分支管理指南:main、dev、feature、release 怎么用

如果冲突了,不要在网页上硬改复杂冲突,拉到本地处理更稳。

总结

PR 的价值是让代码进入主分支前有一次明确检查。分支短一点,描述写清楚,验证命令贴出来,review 才有效。自动检查可以继续看 GitHub Actions 入门:为博客加自动检查