Git 如何只恢复某个提交中的一个文件

想从某个历史提交里取回一个文件，最稳妥的做法是指定提交和文件路径执行 git restore，而不是回退整个分支。它只改工作区中的目标文件，不移动当前分支指针，也不会自动把文件放进暂存区。

官方地址：https://git-scm.com/docs/git-restore

一、先确认来源提交和目标路径

先不要直接点“恢复”。如果仓库里已经有未提交修改，恢复命令可能覆盖目标文件当前内容。进入仓库后，打开“仓库根目录 → 状态”或在命令行执行：

# 先看工作区是否已有未提交改动
git status --short

# 只在目标文件的历史中寻找来源提交
git log --oneline --all -- config/parser.yml

把示例中的 config/parser.yml 换成实际相对路径。图形客户端可以沿着“仓库 → 历史 → 选择提交 → 提交文件列表”进入同一位置；看到目标文件后再打开右键菜单。这里选中的提交只是来源，不代表要把整个提交回滚。

二、恢复前先预览历史版本

确认提交号后，先看文件在该提交中的原样内容。这个动作不会修改工作区：

# 冒号前是提交号，冒号后是仓库内相对路径
git show abc1234:config/parser.yml

# 只比较这个文件，提前看将要带回的差异
git diff abc1234 -- config/parser.yml

如果文件路径含空格，给路径加引号；如果提交里不存在该路径，git show 会报错，此时应回到文件历史重新选择提交。预览阶段能及时发现“找错提交”或“把配置文件恢复到过期状态”这两类常见问题。

三、用 git restore 只取回一个文件

确认无误后执行核心命令。路径前的 -- 用来分隔提交参数和文件参数，能避免文件名看起来像选项时产生歧义：

# 只把 abc1234 中的一个文件写回当前工作区
git restore --source=abc1234 -- config/parser.yml

# 恢复后仍保持未暂存，便于先检查差异
git status --short

如果只想恢复提交中的部分行，可以把“仓库 → 工作区变更 → 目标文件 → 交互式选择”作为图形入口，或使用 git restore -p --source=abc1234 -- config/parser.yml 逐块选择。不要把 git reset --hard 当成替代方案，它的影响范围更大，可能同时丢掉其他文件的工作区内容。

四、检查只改动了这个文件

恢复成功不等于可以立即提交。打开“工作区变更 → 目标文件差异”，或执行下面两条检查：

# 文件列表应只出现预期目标文件
git status --short

# 只查看目标文件的工作区差异
git diff -- config/parser.yml

正常情况下，状态列表会显示一个被修改的路径，差异内容则是当前工作区与暂存区的区别。确认内容正确后，再沿着“目标文件 → 差异确认 → 暂存文件”执行 git add -- config/parser.yml；不需要提交时，到这里就可以结束。

五、常见问题

恢复单文件会改变提交历史吗？

不会。git restore 不移动分支指针；它只是修改工作区，之后是否提交由你决定。

为什么恢复后 git status 显示文件被修改？

这是预期现象：恢复内容先写入工作区，和当前暂存区不同，所以会显示未暂存修改。检查差异后再决定是否 git add。

误恢复覆盖了未提交内容怎么办？

先停止继续操作，检查编辑器备份、文件系统快照或其他副本；若原内容曾经进入暂存区，可先查看 git diff --cached -- 路径，不要立刻用更大范围的 reset 继续覆盖。