GitHub Desktop 如何比较两个分支并只恢复一个文件

想从一个分支拿回某个配置文件，最稳妥的范围控制是：先在 GitHub Desktop 比较分支，确认文件路径和差异，再在当前仓库执行一次只针对该路径的 git restore --source。这样不会把源分支的其他文件一起合并，恢复后还能回到 Changes 面板审阅。

官方地址：https://desktop.github.com/download/

先记住三点：当前分支是接收文件的目标；源分支只提供文件内容；恢复动作最后仍要在 GitHub Desktop 的 Changes 中检查并提交。

先比较分支，确定要取回的文件

假设当前分支是 release-review，需要从 feature/report 取回 app/config.yaml。打开 GitHub Desktop 后，先在顶部仓库栏确认仓库，再点击 Current Branch，切换到 release-review。不要先站在源分支上操作，否则恢复方向很容易反过来。

1. 点击 Current Branch，确认当前分支是 release-review。
2. 再次打开分支菜单，选择 Compare to an existing branch。
3. 选择 feature/report，进入比较视图，在 changed files 中找到 app/config.yaml。

这里的目标不是点击合并，而是核对三件事：文件是否确实存在于源分支、源分支版本是否是你要的内容、相对路径是否准确。GitHub Desktop 的比较入口负责看清范围，单文件写回由下面的 Git 命令完成。

通过 GitHub Desktop 打开仓库命令行

确认差异后，点击菜单栏 Repository，选择 Open in command line。这个入口的价值是直接把命令行定位到当前仓库，不需要手工猜路径。打开后先确认仍在目标分支：

# 确认命令行所在分支，避免把文件写回错误分支
git branch --show-current

# 从源分支取回一个路径，只影响 app/config.yaml
git restore --source feature/report -- app/config.yaml

# 只查看这个文件的差异，确认恢复结果
git diff -- app/config.yaml

--source feature/report 指定内容来源，最后的 -- 用来分隔分支参数与文件路径。只要路径写在它后面，Git 就只处理这个文件。若源分支只在远程存在，可把来源写成 origin/feature/report，但要先确保本地已获取到远程引用。

如果文件路径包含空格，把路径整体用引号包起来；如果当前文件有未提交修改，先在 GitHub Desktop 提交或暂存，避免 restore 覆盖还没有保存的内容。

回到 Changes 审阅并提交单文件变更

命令结束后回到 GitHub Desktop，左侧打开 Changes。正常情况下，列表里会出现 app/config.yaml，展开它可以看到源分支内容与当前文件的差异。先看新增、删除和缩进是否符合预期，再确认列表里没有被误改的其他文件。

1. 在 Changes 中选中 app/config.yaml，阅读完整 diff。
2. 在底部 Summary 填写类似“从 feature/report 恢复配置文件”的提交说明。
3. 确认只有这个文件需要提交后，点击 Commit to release-review。

提交成功的可见状态是 Changes 列表清空，或者只剩下你原本就知道的其他修改。若还要同步远程，再单独点击 Push origin；恢复单文件和推送不是同一个动作。

容易出错的边界与回退方式

• 方向写反：当前分支决定文件写到哪里，源分支决定取什么内容。执行前再运行一次 git branch --show-current。
• 远程分支找不到：用 GitHub Desktop 的 Fetch origin 更新引用，再使用 origin/分支名 作为 source。
• 恢复后发现不对：在提交前可以从 Changes 丢弃这个文件的未提交修改；提交后则应按团队流程用反向修复提交，不要直接重置共享分支。
• 想恢复整个目录：把路径改成目录会扩大影响范围，本例的安全边界是明确写出一个文件路径。

这个流程本质上是“比较确认、单路径取回、界面复核、独立提交”。它不等于合并分支，也不会自动解决其他文件的冲突。

相关问题

只比较分支但不想修改当前文件怎么办？

停留在 Compare 视图阅读差异即可，不执行 git restore。比较本身不会把源分支内容写入当前工作树。

恢复一个文件后为什么 Changes 里不止一个文件？

通常是当前工作树原本就有其他未提交修改，或命令路径写成了目录。逐个查看 diff，先区分原有改动，再决定哪些文件进入本次提交。