<p>git diff 不能用 --exclude，应使用路径规格语法 git diff -- . ':!path' 排除目录；该语法支持多目录 :!dir1 :!dir2，路径须用 /，且需先确认文件是否已被 Git 跟踪。</p>
git diff 怎么跳过某个目录不参与比较
直接在 git diff 命令里加 --exclude 是无效的——这个参数只被 git archive 和某些底层命令识别，git diff 不支持。真正能生效的方式是靠路径过滤或暂存区控制。
- 最常用且稳定的做法：用
git diff -- . ':!path/to/exclude'，其中:!是 Git 的路径规格排除语法，必须写在路径表达式末尾，且前面要有空格和点号（.表示当前目录为根） - 如果要排除多个目录，可以重复写
:!dir1 :!dir2，注意中间用空格分隔，不能用逗号或引号包裹整个字符串 - 该语法只对工作区与暂存区、或两个 commit/分支之间的文件列表生效；它不会影响 Git 内部对象计算，只是过滤输出结果
- Windows 用户需注意：路径分隔符统一用
/，哪怕你在资源管理器里看到的是\，否则:!规则会失效
为什么 gitignore 里的目录在 diff 里还是出现了
.gitignore 只影响未跟踪（untracked）文件是否被 git add 捕获，对已纳入版本控制的目录完全无效。一旦某个目录下的文件曾经被 git add 过，后续所有 git diff 都会照常比对它，不管它现在是否在 .gitignore 里。
- 验证方式：执行
git ls-files path/to/excluded-dir，如果有输出，说明该目录下文件仍在 Git 管理中 - 想彻底让 Git “忘记”一个已跟踪目录，得先清空暂存区：
git rm -r --cached path/to/excluded-dir，再提交；之后它才受.gitignore约束 - 但这么做会影响协作：其他协作者拉取后也会丢失该目录，慎用于团队共享仓库
用 shell 管道临时过滤 diff 输出是否可靠
有人用 git diff --name-only | grep -v 'node_modules' 这类方式“假装排除”，这仅适用于查看阶段，不能用于后续自动化处理（如生成 patch 或同步文件），因为 git diff 默认输出的差异块（hunks）仍包含被过滤路径的内容，只是文件名没显示。
- 真正需要生成干净 patch 时，必须用原生命令过滤，例如：
git diff HEAD~1 -- . ':!dist' ':!build' - 如果脚本里要动态拼接排除路径，注意单引号保护，避免 shell 展开空格或特殊字符：
git diff "$base" -- . ":!$excluded_dir" - 别依赖
awk或sed截断 diff 输出——它们可能切掉关键的元信息行（如diff --git a/file b/file），导致 patch 无法应用
排除目录后，git status 是否同步更新
否。git status 显示的是工作区与暂存区的差异状态，不受 git diff 的路径过滤影响。即使你用 :! 排除了 logs/ 目录，只要里面文件有修改，git status 依然会列出它们。
- 这是设计使然：
git diff是“查看工具”，git status是“状态报告工具”，二者职责分离 - 若想让
git status也不显示某目录，唯一办法是把它从 Git 跟踪中移除（见上文git rm -r --cached），但这属于仓库结构变更，不是临时过滤 - 日常开发中，建议把纯生成物（
dist/、node_modules/、__pycache__/）从一开始就设为 untracked，而不是事后排除
路径排除看着简单，但 :! 语法的位置、引号处理、跨平台路径分隔符，三者任何一个出错都会让过滤静默失败——它不会报错，只是照常输出全部内容。动手前先用 --name-only 跑一遍确认效果，比事后调试快得多。
