Linux tar 怎样排除缓存目录并保留相对路径

在 CI 或备份脚本里，最容易同时踩到两个坑：缓存目录把压缩包撑大，源目录的绝对路径又被误带进命令习惯里。稳定的写法是把项目根交给 -C，把排除规则写在要归档的 . 之前，并用引号保护通配符。

官方地址：https://www.gnu.org/software/tar/manual/

# 以项目根为相对路径基准，同时排除根级和嵌套缓存目录
tar -czf /backup/demo.tar.gz \
  --exclude='cache' \
  --exclude='.cache' \
  --exclude='*/cache' \
  --exclude='*/.cache' \
  -C /srv/demo .

这条命令的关键不在压缩参数，而在两个边界：-C /srv/demo 决定后续文件名从项目根开始解释；--exclude 只负责匹配并跳过目录。用 . 归档整个项目时，成员名可能显示为 ./src/main.go，它仍然是相对路径，不是绝对路径。

旧写法为什么容易把问题混在一起

直接写 tar -czf demo.tar.gz /srv/demo 看起来省事，却把“源目录在哪里”和“压缩包里叫什么”绑定在了一起。即使 GNU tar 通常会去掉归档成员名开头的斜杠，读者仍然要处理顶层目录名、脚本运行位置和不同机器路径不一致的问题。

另一种常见误区是把排除模式写成未加引号的 --exclude *.cache。这时可能先被 shell 展开，tar 收到的就不再是一个稳定的匹配模式。GNU tar 使用 shell 通配规则，不是正则表达式；排除模式还应放在被影响的文件名之前。

新规则：路径根和排除模式分别配置

可以把命令拆成三个阅读单位：-C 规定从哪里开始，四个排除模式规定哪些目录不进入归档，最后的 . 表示把这个根下的内容作为归档输入。这样换机器时只需要替换项目根和输出文件位置，压缩包内部的目录关系不会跟着宿主机绝对路径变化。

# 只归档指定顶层内容时，成员名会更干净，不会带 ./ 前缀
tar -czf /backup/demo.tar.gz \
  --exclude='cache' \
  --exclude='.cache' \
  --exclude='*/cache' \
  --exclude='*/.cache' \
  -C /srv/demo src config README.md

第一种写法适合“整个项目都要收进来”，接受 ./ 作为相对成员名的一部分；第二种写法适合只打包几个明确的顶层目录。不要把两者混成“必须删除 ./ 才算相对路径”，真正需要关注的是成员名有没有以 / 开头，以及缓存目录是否仍出现在成员列表里。

代码对比：怎样判断结果符合预期

查看目录表不需要解压，也不需要打开压缩文件。先用 -t 列出成员，再根据项目结构观察三件事：业务目录是否仍保持层级、缓存目录是否消失、成员名是否是相对形式。

# 只读取压缩包目录表，快速检查成员名和缓存排除结果
tar -tzf /backup/demo.tar.gz | sed -n '1,30p'

如果结果里出现 /srv/demo/...，说明命令把绝对源位置直接当成了成员名来源；如果仍出现 node_modules/.cache/ 或 build/cache/，说明排除模式没有覆盖实际层级，应该补充对应的目录模式，而不是盲目删除归档文件。

兼容注意和采用建议

• 通配符要加引号：* 应交给 tar 匹配，不能让当前 shell 先展开。
• 排除项要放在输入项前：不要把 --exclude 写在最后再指望它影响前面的 .。
• 模式要按成员名思考：根级目录和嵌套目录可以分别写模式，缓存目录名称不一定固定在同一层。
• 相对路径不等于没有 ./：需要干净顶层名时，枚举顶层输入项比事后改包更直观。

如果你的目标只是备份项目，第一条命令通常足够；如果归档要交给部署脚本消费，第二条命令更容易让脚本依赖稳定的顶层成员名。无论选哪种写法，都先用 tar -tzf 阅读目录表，再决定是否交付。

相关问题

为什么排除模式写成正则表达式没有效果？ GNU tar 的 --exclude 使用 shell 通配模式，应该按文件名和路径片段组织 *、目录名等模式，而不是使用正则语法。

怎样只排除项目根目录下的 cache？ 让归档根固定在项目目录后，可以使用更具体的根级模式，并用 tar -tzf 查看是否误伤嵌套目录。