最常见原因是工作目录有未提交修改或参数顺序错误；应先清理干扰、确认分支存在，用三个点语法比较共同祖先，注意--分隔路径、-u和--word-diff控制输出粒度。
git diff 比较两个分支时，为什么没输出或显示“无差异”？
最常见原因是当前工作目录有未提交/未暂存的修改，干扰了比较结果；或者你误用了参数顺序（git diff A B 和 git diff B A 输出方向相反，但内容逻辑不同）。Git 默认比较的是「A 到 B 的变更」——即「B 中有、A 中没有的内容」，不是对称操作。
实操建议：
- 先清理干扰：运行
git status确认工作区和暂存区干净；如有修改，用git stash临时保存再试 - 确认分支存在：用
git branch -a查看本地+远程分支，避免拼写错误（比如mainvsmaster） - 强制指定比较起点：明确写成
git diff 分支名1...分支名2（三个点），Git 会自动找两者的最近共同祖先，更符合直觉 - 别依赖当前所在分支：
git diff feature/login develop不需要先git checkout develop，直接执行即可
只想看改了哪些文件，不关心具体行内容？用 --name-only 和 --name-status
当分支差异大、文件多时，全量 diff 会刷屏。这时候用 --name-only 只列出文件路径，--name-status 还能附带操作类型（A 新增、M 修改、D 删除）。
示例：
git diff main...dev --name-status
输出可能为：
M src/utils.js<br>A test/integration.spec.ts<br>D legacy/config.yaml
注意：--name-status 在比较分支时才可靠；若用于工作区对比（如 git diff --name-status），它只反映未暂存修改，和 --staged 组合才有意义。
比较单个文件在两个分支间的差异，路径怎么写？
关键在 -- 符号：它用来分隔 Git 参数和文件路径，防止路径被误认为分支名。漏掉它，Git 可能报错或行为异常。
正确写法：
-
git diff main dev -- src/api/client.ts（比较两个分支中该文件） -
git diff main -- src/api/client.ts（只比 main 分支版本和当前工作区版本） -
git diff --cached -- src/api/client.ts（比暂存区和上次提交中该文件）
路径是相对于仓库根目录的，不是当前 shell 路径。如果在子目录下执行，仍要写完整相对路径，比如 src/ 开头，不能只写 client.ts。
diff 输出太长看不清？加 -U 或用 --word-diff 控制粒度
默认上下文是 3 行，有时不够定位；有时又太多。用 -U5 把上下文扩到 5 行，或 -U0 去掉所有上下文（只剩 +/- 行），视调试需求而定。
更实用的是 --word-diff：按单词而非整行标差异，对文案、JSON、配置项改动更友好。
例如：
git diff -U0 main...dev -- package.json
或：
git diff --word-diff=plain main...dev -- README.md
注意：--word-diff 对二进制文件无效；且某些特殊字符（如引号嵌套）可能导致分词不准，这时退回 -U 更稳妥。
真正容易被忽略的点是：Git 的 diff 默认不递归比较子模块，也不处理符号链接内容变更；如果你的项目含子模块，得额外加 --submodule 参数，否则看似“没变化”的文件其实已被更新。
