GitHub Desktop 按提交恢复单个文件的操作

在 GitHub Desktop 里想“按某次提交恢复一个文件”，最稳妥的做法是：先在 History 找到目标提交，再通过 Repository → Open in command line 打开仓库命令行，用 Git 的 source 参数只写回一个文件，最后回到 Changes 检查差异。这样不会把整个分支回退，也不会把同一提交里的其他文件一起带回来。

官方地址：https://docs.github.com/en/desktop/managing-commits/checking-out-a-commit-in-github-desktop

相关操作说明：https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop

先分清“恢复单文件”和“重置提交”

GitHub Desktop 的 History 主要负责浏览提交和管理提交历史；Reset to commit 会把选中提交之后的改动恢复到工作区，并重置分支指针，不适合只取回一个文件。若目标是把 docs/config.yaml 恢复到某个旧提交，应该把提交哈希和文件路径同时作为边界。

操作前先看 Changes：如果当前文件还有未提交改动，先提交、暂存，或复制到安全位置。恢复动作会改写工作区里的目标文件，未保存内容不能靠“撤销”保证找回。

从 History 定位提交，再只恢复一个路径

打开仓库后，左侧点击 History，选择包含目标文件正确版本的提交。右侧确认提交摘要、作者和时间，复制完整提交哈希的前 7 位或更长前缀。然后点击顶部菜单 Repository → Open in command line，确保命令行当前目录就是这个仓库。

假设提交是 4f81c2a，文件是 docs/config.yaml，命令如下。-- 用来分隔提交参数和路径，避免文件名被误当成提交对象：

git restore --source 4f81c2a -- docs/config.yaml
# 只查看目标文件的恢复差异，不改动其他路径
git diff -- docs/config.yaml
# 确认文件内容后再加入暂存区
git add -- docs/config.yaml

这条命令改变的是当前工作区文件，不会自动创建提交，也不会把提交里的其他文件复制过来。若旧版本来自另一个分支，先在 History 或分支选择器确认它确实已在本地对象库中；找不到提交时，不要猜哈希继续执行。

回到 Changes 做三项确认

命令执行后切回 GitHub Desktop 的 Changes。先看变更文件数量是否只有目标文件，再打开 diff，确认新增、删除内容确实来自目标提交。最后检查当前分支没有因为 Reset、Checkout 或切换分支而发生意外变化。

确认后输入新的提交说明并提交，或者把这次恢复作为后续改动的一部分继续编辑。若发现恢复错了，在提交前可以用正确的提交重新执行同一条单文件命令；已经推送的恢复提交则应按团队协作规则处理，不要随意改写共享历史。

常见问题

为什么 History 里看得到提交，却不能直接恢复其中一个文件？

GitHub Desktop 的历史操作更偏向提交级管理，单文件取回可以通过它提供的 Open in command line 入口交给 Git 完成，边界更明确。

执行后为什么 Changes 里出现了文件？

这是预期结果：恢复先写入工作区，尚未自动提交。检查 diff 无误后，再决定是否暂存和提交。

能否直接点击 Reset to commit？

不建议。Reset 会影响选中提交之后的整体改动；只恢复一个文件时，使用带文件路径的 git restore 更安全。