GitHub Desktop 怎么预览 Pull Request：Changes、History 与 base 分支核对

在 GitHub Desktop 里改完代码，最容易踩坑的环节往往不是点提交，而是误把无关文件、不对的目标分支塞进 Pull Request。稳妥的校验流程是：先在 Changes 页面核对未提交的改动内容，再进 History 页确认提交范围没问题，最后点 Preview Pull Request 核查 base 分支和最终合并状态。

先把 Current Branch 和工作区状态对应上

打开仓库后，先看窗口顶部的 Current Branch 区域。这里显示的是当前本地签出的分支，不是后续要合并进的目标分支。比如本次改动属于 feature/login-copy，这里就不应该还停留在 main。

如果当前分支不对，点击 Current Branch 唤出分支列表，选中你要操作的工作分支。GitHub Desktop 切换分支前会提示还有未提交的改动，这时候不用急着点确认，先判断手里的改动应该提交、暂存还是直接丢弃。未提交内容跨分支随意迁移，会导致后面的差异预览范围完全混乱。

Changes：逐文件确认本次要提交的内容

左侧边栏点击 Changes，中间区域会列出当前分支还没提交的所有文件。点开单个文件后，右侧的差异面板只会展示改动过的代码行，能快速排查出调试输出、本地临时配置这类不该进入代码评审的文件。

提交前建议过一遍简单的校验清单：

核对完成后，在 Changes 面板底部填写提交概要，必要时补充详细描述，再点击标有当前分支名的提交按钮。提交完成后，页面会自动切到没有未提交改动的干净状态。

History：确认提交没有落错分支

点击左侧边栏的 History，查看当前分支的所有提交记录。选中刚生成的那条提交，右侧面板可以再次查看这次提交改动的全部文件。这里重点确认三个信息：提交标题是否能清晰描述改动内容、这条提交是不是确实落在当前工作分支下、改动文件列表和 Changes 阶段的预期完全一致。

如果提交后发现标题写错或者文件范围不对，先在本地修正问题，不要急着创建 Pull Request。GitHub Desktop 支持直接在提交记录上二次核对差异；涉及提交内容修正时，先确认团队其他成员还没拉取到这条提交，再选合适的方式修改，避免影响其他人。

Preview Pull Request：核查 base 分支和合并提示

提交完成且把本地分支发布到远端后，点击 Preview Pull Request。GitHub Desktop 会弹出预览窗口，展示当前分支相对 base 分支的全部改动。这个页面的内容不是 Changes 面板的简单重复：Changes 看的是工作区到本地提交前的临时改动，Pull Request 预览看的是整个分支后续要给评审者看的累计差异范围。

在预览窗口第一时间核对 base 下拉选择框。日常功能迭代通常合入默认分支，但不少团队也会要求先合入 develop 或者对应发布分支。确认完 base 分支再看界面给出的合并提示：显示可以自动合并代表当前差异没有检测到直接冲突；显示无法自动合并就需要回到本地分支处理完冲突再继续，不要直接跳过这个步骤。

全部信息确认无误后点击 Create Pull Request，GitHub Desktop 会自动唤起浏览器跳转到 GitHub 的对应页面。这里再复核一次标题、描述和目标分支，如果还没准备好对外公开评审，可以选择创建 Draft Pull Request。

三个容易混淆的状态说明

• 没有未提交改动：仅代表 Changes 页的工作区是干净的，不代表当前分支和 base 分支的内容完全相同。
• 分支已经发布：仅代表远端服务器存了这个分支，不代表 Pull Request 的 base 分支选对了。
• 可以自动合并：仅代表当前系统检测没有直接的合并冲突，人工还是要检查业务逻辑和测试文件的正确性。

常见问题

为什么看不到 Preview Pull Request 按钮？

通常是当前分支还没发布到远端，或者当前分支不存在相对 base 分支的可预览提交。先完成本地提交、点击 Publish branch 把分支推到远端，再重新查看仓库状态就好。

base 分支选错了怎么处理？

不要直接创建 Pull Request。回到预览窗口更换 base 分支就行；如果已经跳转到 GitHub 的 Pull Request 页面，直接在页面编辑目标分支再提交。

Changes 和 Pull Request 预览的差异为什么对不上？

Changes 面向的是当前工作区还没提交的临时内容，Pull Request 预览面向的是当前分支和 base 分支的累计差异。如果分支上有多个历史提交，两者显示的范围自然不一样。

显示能自动合并就可以不用看文件差异了吗？

不行。自动合并只做分支层面的直接冲突判断，没法替你排查出误提交的配置、日志或者业务逻辑错误。

GitHub Desktop 里的最小校验流程可以记成：Current Branch → Changes → History → Publish branch → Preview Pull Request。每一步只确认一个维度的问题，最后再统一核对 base 分支、差异范围和合并提示，发起 Pull Request 就很难出低级错误。