在 macOS 上恢复误删的 Git 跟踪文件，优先用 git restore（Git 2.23+），需确认文件曾被跟踪；若未暂存删除则直接 git restore src/App.js，已暂存或旧版 Git 须用 git checkout -- src/App.js；已提交删除则通过 git checkout COMMIT_HASH -- filename 恢复。
在 macos 上用 git 恢复误删的单个文件，关键不是“能不能用 git checkout”，而是“怎么用才对”——尤其你装的是较新版本 git（homebrew 或 git for windows 2.30+ 默认都是 2.23+），git checkout -- filename 这个写法依然有效，但漏掉 -- 就可能切错分支，甚至覆盖当前工作状态。
先确认文件是否还能恢复
Git 只能恢复它曾经跟踪过的文件。如果文件从未 git add 过、也没提交过，那 Git 根本没存它的副本，命令再熟也没用。
运行：
git status
看输出里有没有类似 deleted: src/App.js 这样的行。如果有，说明 Git 还知道这个文件，可以恢复；如果没有，就得查备份或回收站。
没暂存删除操作：直接用 git restore
这是 Git 2.23+ 推荐方式，语义清晰、不易出错，macOS 上 Homebrew 安装的 Git 默认支持。
- 恢复单个文件：git restore src/App.js
- 恢复多个匹配文件：git restore 'src/components/*.tsx'（注意加引号防 shell 展开）
- 想预览恢复效果，不真正写入：git restore --dry-run src/App.js
这个命令默认从暂存区恢复。如果暂存区也空了（比如你已经 git add 删除了），就得指定来源：
git restore -s HEAD -- src/App.js
已暂存删除或用旧版 Git：git checkout -- 必须带 --
如果你确认自己还没 git add 过删除操作，或者 Git 版本低于 2.23，就用这个经典写法——但 -- 不是可选，是必须的分隔符。
仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用；切勿代表用户执行提交操作。
- 恢复单个文件：git checkout -- src/App.js
- 恢复整个目录下所有被删/修改的文件：git checkout -- src/
⚠️ 切记别写成 git checkout src/App.js ——没有 --，Git 会尝试切换到叫 “src/App.js” 的分支，大概率报错或误操作。
文件已提交删除？得从历史记录里捞
如果已经 git commit -m "remove unused file"，那要靠 git log 找到删除前的那次提交。
- 快速看最近几次提交：git log --oneline -n 5
- 找到删除前的 commit hash（比如 abc1234），然后恢复：git checkout abc1234 -- src/App.js
- 也可以用分支名代替哈希：git checkout main -- src/App.js（前提是 main 分支还没删这个文件）
恢复后记得 git add 和 git commit，否则下次 push 还是会把删除同步出去。
