Git拉取请求（Pull Request）：在GitHub上发起PR的完整流程

在GitHub上，Pull Request（简称PR）是开发者向项目仓库提交代码修改的重要方式。简单来说，当你完成了新功能开发或问题修复，希望将这些修改合并到项目的主分支（比如main或master）时，就可以通过发起PR来实现。PR能让项目的维护者和团队成员看到你的修改，共同审查代码质量，确保修改安全且符合项目规范。

为什么需要PR？¶

代码审查：PR是团队协作的核心机制，其他人可以通过你的代码提交了解修改内容，提出建议或批评，避免直接合并“带病”代码到主分支。
历史记录：PR会记录所有修改的上下文（如修改目的、测试结果），方便后续追踪和回溯。
规范协作：通过PR流程，团队可以统一代码风格、测试标准和提交规范，减少混乱。

发起PR前的准备工作¶

在创建PR前，需要确保本地代码已经准备妥当，避免因基础问题导致PR失败。具体步骤如下：

提交本地修改
假设你在本地开发分支（如feature/new-login）完成了功能开发，需先将修改提交到本地仓库：

   git add .  # 添加所有修改文件
   git commit -m "Add user login form validation"  # 提交并填写清晰的提交信息

更新分支（避免冲突）
如果项目主分支（如main）有新的更新（比如其他开发者合并了代码），需先同步到你的分支，确保本地分支是最新的：

   git checkout main  # 切换到主分支
   git pull origin main  # 拉取主分支最新代码
   git checkout feature/new-login  # 切回自己的分支
   git merge main  # 将主分支的更新合并到你的分支

若合并时出现冲突（如同一文件被多人修改），需手动解决冲突后再次提交。

确认提交状态
执行git log检查提交记录，确保所有修改已正确提交且分支状态干净（无未暂存的修改）。

在GitHub上创建PR的步骤¶

完成本地准备后，即可在GitHub仓库页面发起PR，具体操作如下：

进入PR创建页面
打开目标仓库（如你fork的仓库或团队共享仓库），点击页面顶部的“Pull requests”标签，然后点击“New pull request”按钮。
选择分支
- Base分支：选择你希望合并到的目标分支（通常是项目主分支，如main）。
- Compare分支：选择你修改的分支（如feature/new-login）。
GitHub会自动检查分支是否有冲突，若有冲突会提示“Can’t create a merge…”，此时需回到本地解决冲突（参考上文“更新分支”步骤）。
填写PR信息
确认分支无误后，点击“Create pull request”进入PR详情页，填写以下关键信息：
- 标题：简洁明了，如“Add user login form validation”。
- 描述：详细说明修改目的（如“修复用户反馈的登录失败问题”）、具体实现（如“新增手机号验证码登录方式”）、测试结果（如“已在本地测试通过”）。
- 关联Issue：若项目用Issue跟踪问题，可在描述中填写“Fixes #123”（#123为Issue编号），合并PR时会自动关闭该Issue。

代码审查与修改反馈¶

提交PR后，项目维护者或团队成员会收到通知，他们会通过评论提出修改意见（如“变量名需更清晰”“缺少单元测试”）。此时你需要：

根据反馈修改代码：在本地分支中调整代码，再次提交修改（git commit -m "Fix review comments"）。
更新PR：提交后，GitHub会自动刷新PR页面，显示最新修改状态。
回复与沟通：对审查意见逐一回复（如“已修改变量名为user_phone”），确保沟通顺畅。

合并PR的方法¶

当所有审查意见通过后，即可合并PR到目标分支。GitHub提供三种合并方式，初学者推荐使用：

Squash and merge（推荐）
将你PR中的所有提交压缩为一个提交，保持目标分支历史简洁。适合小型修改，避免杂乱的提交记录。
操作：点击PR页面右侧的“Merge pull request”，选择“Squash and merge”，确认合并后点击“Confirm squash and merge”。
Rebase and merge
将你的分支提交“重放”到目标分支顶部，形成线性历史。适合复杂分支合并，但需谨慎使用（可能修改历史）。
Create a merge commit
保留所有提交记录，创建一个新的合并提交。适合大型PR或需完整保留提交历史的场景。

合并后的后续操作¶

PR合并后，可执行以下步骤保持仓库整洁：

删除源分支：在PR页面点击“Delete branch”，删除已合并的分支（如feature/new-login），避免仓库分支冗余。
同步本地分支：若你后续还需开发，可删除本地分支并重新拉取主分支：

   git checkout main
   git pull origin main
   git branch -d feature/new-login  # 删除本地分支

常见问题与注意事项¶

分支命名规范：给分支起有意义的名字（如bugfix/login-error），避免使用无意义的feature或dev。
提交信息清晰：每次git commit的信息需简洁，说明修改目的（如“Fix: 修复移动端适配问题”）。
小而聚焦的PR：尽量让每个PR只解决一个问题，避免大PR（超过500行代码）导致审查困难。
冲突处理：若合并时提示冲突，优先在本地解决（git merge或git rebase），再提交修改。

通过以上步骤，你就能熟练在GitHub上发起PR，实现安全、规范的代码协作。记住，PR不仅是提交代码的流程，更是团队沟通和代码质量保障的重要环节。