Git 如何只重置单个文件（hard reset）
用 git restore --source=HEAD --staged --worktree -- 文件 同时重置单文件的暂存区与工作区。操作会覆盖本地改动，先检查差异并备份。
一句话回答：用 git checkout HEAD -- 路径/文件名 把单个文件还原到 HEAD（当前分支最新提交）的状态，该文件的未暂存和已暂存改动都会被丢弃，其他文件不受影响。Git 2.23+ 的语义化写法是 git restore --source=HEAD --staged --worktree 文件。Git 不保证能恢复被覆盖的未提交改动，执行前确认改动真的不要了。
命令用法
# 经典写法
git checkout HEAD -- path/to/file.txt
# 还原到某个历史提交
git checkout abc1234 -- path/to/file.txt
# 批量还原多个文件
git checkout HEAD -- src/a.js src/b.js
Git 2.23+ 推荐写法（语义更清晰）：
git restore --source=HEAD --staged --worktree path/to/file.txt
# 简化：只丢弃工作区改动（不动暂存区）
git restore path/to/file.txt
-- 为什么不能省
-- 是分隔符，告诉 Git"后面的是文件路径而不是分支名"。如果文件叫 dev 而仓库恰好有 dev 分支，不写 -- 时 git checkout dev 会切分支而不是还原文件——所以养成永远带 -- 的习惯。
与其他还原操作的区别
| 需求 | 命令 |
|---|---|
| 丢弃单个文件的全部本地改动 | git checkout HEAD -- 文件 |
| 丢弃整个仓库的未提交改动 | git reset --hard HEAD |
| 只取消暂存（保留工作区改动） | git restore --staged 文件 |
| 撤销已提交的修改（生成反向提交） | git revert 提交号 |
误重置了怎么救
- 文件曾暂存过（git add 过）：若对象尚未清理，可尝试
git fsck --lost-found寻找 blob；不保证完整恢复或保留文件名 - 从未 add/commit：Git 通常无法找回，需查看编辑器历史或外部备份——这也是执行前要先
git diff 文件确认的原因 - 保险做法：先检查
git diff -- 文件与git diff --cached -- 文件，再git stash push -- 文件或外部备份
常见问题（FAQ）
Q：git checkout -- 文件（不带 HEAD）有什么区别？
A：不带 HEAD 时从暂存区还原到工作区：工作区改动被丢弃，但已 add 进暂存区的改动保留。带 HEAD -- 则是连暂存区一起还原到提交状态，更彻底。
Q：只想丢弃文件的一部分改动？
A：用交互式：git checkout -p HEAD -- 文件，Git 会逐块（hunk）询问是否丢弃；或者用 git stash -p 反向操作，把想保留的 stash 起来再重置。
Q：这个操作会影响远程仓库吗？
A：不会。checkout/restore 都是纯本地操作，只有 push 才会影响远程。
核查依据
本文依据官方文档核对，示例未在实际业务环境运行；上线前请按部署版本、权限与数据范围验证。
