Linux tar 排除多个目录时模式为何不生效

Linux 中多个目录排除失败，通常不是 tar 不能写多个规则，而是“规则看到的路径”和“归档成员名”没有对齐。GNU tar 会把 `--exclude` 后面的模式与待加入归档的成员名比较；如果源参数是 project，规则一般也应写成 project/.git、project/node_modules 这样的前缀。通配符则必须加引号，避免先被 shell 展开。

官方文档：https://www.gnu.org/software/tar/manual/tar.html

先把 tar 的匹配对象对齐

先不要急着增加更多星号。下面这条命令把整个 project 作为源目录，因此归档成员名会带上 project/ 前缀：

# 规则使用与源参数一致的 project/ 前缀
tar --exclude='project/.git' \
    --exclude='project/node_modules' \
    --exclude='project/var/cache' \
    -czf project-backup.tar.gz project

这里的三个模式分别保护 Git 元数据、依赖目录和运行缓存。目录模式命中目录后，递归内容也会被排除。若你改成在 project 目录内执行 tar -czf ../project-backup.tar.gz .，成员名通常会变成 ./.git、./node_modules，此时继续使用 project/ 前缀自然匹配不到。

多个 --exclude 为什么看似写了却没有生效

最常见的三个原因是参数位置、通配符展开和路径前缀。为了让命令在不同脚本环境下更容易读懂，建议把所有排除项集中放在源目录之前，并给模式加单引号：

# 单引号阻止 shell 提前展开星号；每个目录单独写一条规则
tar --exclude='project/.git/*' \
    --exclude='project/node_modules/*' \
    --exclude='project/logs/*' \
    -czf project-backup.tar.gz project

目录本身和目录内容是两个不同需求。只写 project/logs，表达的是不把这个成员及其递归内容加入归档；写成 project/logs/*，更接近“保留目录项，但排除它下面的内容”。如果目标是备份时完全看不到该目录，优先使用不带 /* 的目录模式。

不要写成未引用的 --exclude=project/logs/*。当当前工作目录恰好存在匹配项时，shell 可能在 tar 启动前把星号换成一串文件名，最终传入的就不再是你以为的一个模式。参数顺序也不要依赖旧环境的宽松解析：把选项先写完，再写 -f、输出文件和源目录，排查成本最低。

用成员清单确认排除结果

tar 返回 0 只能说明归档过程结束，并不代表排除目标一定正确。创建后先列出成员名，再针对关键目录做反向检查：

# 列出 gzip 压缩归档中的成员名，观察实际前缀
tar -tzf project-backup.tar.gz | sed -n '1,30p'

# 检查不应出现的目录；没有输出才表示这些前缀未进入归档
tar -tzf project-backup.tar.gz | grep -E '(^|/)(\.git|node_modules|var/cache|logs)(/|$)' || true

grep 这一段只是检查路径，不会改变归档。加上 || true 是为了让“没有匹配项”不会在启用 set -e 的备份脚本中被当成失败；如果你需要把误匹配当成硬错误，则应去掉它并明确处理返回码。

常见问题

为什么 --exclude 要尽量放在源目录前面？

这样可以避免不同 tar 版本或选项解析方式造成歧义，读者也能一眼看到规则作用于哪个源目录。固定写法比依赖位置副作用更适合脚本。

--exclude='logs' 会排除所有层级的 logs 吗？

它可能匹配归档成员中的同名路径，范围取决于成员名和模式；生产脚本不要猜，使用完整前缀如 project/logs，再用 tar -tzf 检查。

为什么排除归档文件本身也很重要？

如果输出文件放在待打包目录里，下一次运行可能把旧归档再次收入新归档。把输出写到源目录外，或增加精确的排除规则，能避免备份不断膨胀。