在开源社区和企业级团队协作中，Pull Request（简称PR）是代码合并的核心机制。它不仅是一个技术动作，更是保障软件质量、促进团队沟通的关键环节。很多开发者本地编写代码很顺手，但一旦涉及分支管理、远程同步和冲突解决，就容易卡壳。本文将从零开始，用最直白的语言拆解提交流程，帮你避开常见陷阱，一次性顺利通过代码审查。
获取权限与克隆仓库
提交PR的前提是你拥有该项目的贡献资格。对于开源项目，通常需要先在网页端点击Fork按钮，将目标仓库完整复制到你自己的账号下。如果是企业内部项目，则需向项目负责人申请对应的读写权限。权限开通后，打开命令行工具，输入git clone加项目SSH或HTTPS地址，将代码拉取到本地电脑。进入项目根目录后，强烈建议配置上游仓库地址。执行git remote add upstream原仓库链接命令，这能让你同时追踪自己的副本和官方主干，为后续同步代码打好基础。
创建独立分支与提交更改
绝对不要在主分支main或master上直接动手修改。规范的协作模式要求每次任务都对应一个独立分支。使用git checkout -b分支名称新建并切换分支，命名建议采用类型加简述的格式，例如fix-auth-error或add-export-module。在分支内完成代码编写后，使用git status核对变更文件，确认没有误删或遗漏。接着运行git add .暂存所有修改，随后执行git commit -m提交说明。提交信息必须言简意赅，明确指出修改了哪个模块以及解决问题的思路，这能极大提升后续审查效率。
同步上游代码避免落后
在你专心开发期间，主仓库大概率已经合入了其他人的更新。如果此时强行推送，极易因版本差异引发自动合并失败。标准做法是先切回主分支，抓取官方最新快照，再回到功能分支进行变基。具体操作为：git checkout main获取控制权，git fetch upstream拉取远端元数据，git merge upstream/main合并最新内容。之后git checkout切换回你的分支，执行git rebase main将你的提交历史整齐地放在最新主干之上。这一步看似繁琐，却是保证代码库线性整洁的最有效手段。
推送分支与填写PR详情
代码与历史线理顺后，执行git push origin分支名将本地成果推送到你的云端仓库。若首次推送遇到无上游分支的报错，追加-u参数重跑一次即可。推送完毕，打开浏览器访问代码托管平台，系统通常会弹出对比链接。点击进入PR创建界面，左侧锁定目标主干分支，右侧选定你的功能分支。在标题栏概括核心改动，在描述框详细说明测试步骤、影响范围及关联工单号。清晰的结构能让审查者快速抓住重点，大幅缩短反馈周期。
响应审查与最终合并
发起请求只是开始，后续的互动才是重点。审查人员可能会提出重构建议、指出潜在风险或要求补充日志。你只需在本地继续调整，重复暂存、提交和推送操作，所有更新都会自动追加到同一个PR记录里。若系统提示文件冲突，打开标注红绿区块的文件手动对齐逻辑，保存后再提交一次。当静态扫描全绿且获得至少一名负责人批准后，即可点击合并按钮。合入成功后，记得清理本地和远端的临时分支，养成定期整理的工作习惯。
