Git restore 怎么只撤销一个文件的工作区修改

改了三个文件，只有一个配置文件想退回原样时，最稳妥的做法是把路径写在 git restore 后面：git restore -- demo-app/src/config.yaml。它只恢复这个文件的工作区内容，其他文件不会因为你执行了恢复而一起消失。

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

一、先在 Changes 面板锁定目标文件

先不要直接输入整仓库恢复命令。在 Git 客户端的 Source Control → Changes 面板中，找到要撤销的文件，确认它标记为 Unstaged，再展开 Diff 看一眼。假设 config.yaml 是误改内容，README.md 仍是有意保留的修改，那么本次操作的目标只能是前者。

如果习惯命令行，可以在仓库目录执行下面的检查。输出中带有 M 的行表示工作区有修改；左侧空格意味着索引没有这项变化。

# 只查看文件状态，不改变任何内容
git status --short

# 只查看目标文件的工作区差异
git diff -- demo-app/src/config.yaml

二、执行 git restore -- 文件路径

确认路径后，在仓库根目录打开客户端内置终端或系统终端，输入恢复命令。菜单路径可以记成 Terminal → New Terminal → 仓库根目录，命令中的 -- 是选项结束标记，后面的内容会按文件路径处理。

# 只恢复一个文件的工作区内容，保留其他路径的修改
git restore -- demo-app/src/config.yaml

这里没有使用 --staged，所以 Git 默认把工作区文件恢复为索引中的版本。换句话说，如果这个文件只是改了但没有执行 git add，这条命令正好撤销未暂存部分；已经暂存的版本不会因为这一步被改写。

三、检查状态和差异

恢复后回到 Source Control → Changes，或者再次运行状态检查。目标文件不再出现在工作区差异中，而 README.md 仍然保留，才说明操作范围正确。

# 确认目标文件已经没有工作区差异
git diff --quiet -- demo-app/src/config.yaml

# 再看整体状态，确认其他文件仍按原状态存在
git status --short

git diff --quiet 没有输出并返回成功，表示目标文件相对索引没有工作区差异。若仍看到目标文件，先检查当前目录、路径大小写和文件是否实际被暂存。

四、处理暂存文件和误操作边界

最容易混淆的是“工作区”和“暂存区”。如果文件已经执行过 git add，只运行不带参数的 git restore，可能只清掉工作区相对索引的变化，暂存版本仍会留下。此时先判断你要撤销的是哪一层：

如果只想撤销文件中的一小段，不要直接整文件恢复，可以使用 git restore -p -- file 逐块选择；如果文件名包含空格，保留引号或使用 --pathspec-from-file，不要让 shell 先拆分路径。

常见问题

执行 git restore 后能找回误删内容吗？

未提交、未暂存的内容通常不会由 Git 保留，执行前应先用编辑器撤销、复制备份，或用 git diff > backup.patch 保存补丁。

为什么 git restore . 会影响多个文件？

点号代表当前目录下匹配到的路径。只撤销一个文件时必须把明确的文件路径写在 -- 后面。

git restore 和 git reset 一样吗？

不完全一样。restore 面向工作区或索引中的文件内容，reset 还涉及 HEAD 和提交历史移动；本次单文件工作区回退优先使用 git restore。

最终确认：只撤销目标文件

完成后核对三件事：目标文件的 git diff -- file 没有输出；其他文件的状态仍与执行前一致；如果目标文件曾经暂存，再额外检查 git diff --cached -- file。这套“先锁定路径、再恢复、最后复查”的顺序，能把 Git restore 的影响范围控制在一个文件内。