<p>git diff A B -- path/to/file 必须按“旧→新”顺序，A为基准（-行来源），B为目标（+行来源）；路径须存在且区分大小写，需置于--后，含空格时加引号。</p>
直接用 git diff 指定两个 commit 或分支 + 路径，就能精准比对单个文件在不同版本间的差异——但顺序、路径写法和是否加引号，稍不注意就白跑命令。
git diff A B -- path/to/file 的顺序不能颠倒
Git 把左边当基准（old），右边当目标（new）。写成 git diff abc123 def456 -- src/main.js，输出的 - 行来自 abc123，+ 行是 def456 新增的内容。如果反过来写成 git diff def456 abc123 -- src/main.js，你看到的其实是“从新版本删掉哪些才能回到旧版”，不是增量变更，而是逆向回滚逻辑。
- 读作“从 A 到 B 改了什么”，就严格写
git diff A B -- file - A 和 B 可以是完整 SHA、短哈希（至少 7 位）、分支名、标签、
HEAD~2等 - 如果提示
fatal: ambiguous argument，大概率是哈希太短（比如只输 5 位）或本地没 fetch 过该远程引用
比较不同分支上同一文件时，路径必须存在且拼写一致
比如想看 main 和 feature/login 中 package.json 的区别，命令是 git diff main feature/login -- package.json。但如果 package.json 在 feature/login 分支里已被重命名或删除，Git 会报错 error: can't find package.json in commit xxx，而不是静默跳过。
- 先确认文件在两个版本中都存在：
git ls-tree -r main -- package.json和git ls-tree -r feature/login -- package.json - 路径区分大小写，
src/Utils.js和src/utils.js是两个文件 - 路径开头不加
/，否则 Git 会按绝对路径解析，导致找不到
用 git show 查看某次提交中文件的快照内容
当你只需要看某个 commit 里某个文件长什么样（而非对比），git show 更轻量。例如 git show abc123:src/api/client.ts 直接输出该 commit 下该文件的完整内容。
- 冒号
:是分隔符，左边是 commit/branch/ref，右边是相对于仓库根目录的路径 - 如果路径含空格或特殊字符，整个
commit:path需用引号包裹，如git show HEAD:"docs/my notes.md" - 搭配
git show abc123:package.json | jq .version可快速提取结构化字段，适合 CI 场景
--no-index 不适用于跨版本文件比对
git diff --no-index 只用于比较**非 Git 管理的文件或目录**，比如两个本地未纳入版本控制的配置副本。它完全绕过 Git 历史，也不识别 commit、分支等概念。若强行用它去比 repo1/.git/ 和 repo2/.git/，结果不可信——Git 仓库元数据本身就不该被这样比。
- 跨仓库比文件？用
git diff --no-index path1/file.js path2/file.js，前提是这两个路径都不在任何 Git 仓库下（或已用cd /tmp && git init隔离） - 想比两个仓库中相同路径的文件在各自 HEAD 的状态？得先
git worktree add或临时 clone 出来再比 - 误用
--no-index对 commit 引用，Git 会直接报错fatal: This operation must be run in a work tree
最容易被忽略的是：路径参数必须放在 -- 后面，否则 Git 可能把它当成 ref 解析；而 -- 本身不能省略，尤其当路径以 - 开头（如 -config.yaml）时，缺了它命令就彻底失效。
