Linux tar 排除多个目录时怎么避免通配符误匹配

用 Linux tar 归档多个目录时，最稳妥的写法是：先看归档成员名，再给每条 --exclude 模式加单引号；固定目录使用完整路径前缀，跨多个项目才使用通配符。不要直接把 node_modules 交给 shell 猜，也不要把排除结果当成理所当然，最后用 tar -tf 列出归档内容确认。

先把路径口径和通配符边界定清楚

tar 匹配的不是磁盘上的“目录对象”，而是它准备写入归档的成员名。命令写成 tar -czf backup.tar.gz project/ 时，归档里的路径通常带有 project/ 前缀；排除规则也应围绕这个前缀来写。固定目录优先使用 project/.git、project/node_modules 这类窄模式，避免同名目录被一起排除。

另一层边界来自 Shell。*、? 和字符组本来会被 Shell 当作通配符处理；如果当前目录恰好存在匹配项，tar 甚至可能收到一组已经展开的文件名。给模式加单引号，才能让它原样交给 tar。

多个目录怎么用 --exclude 组合

规则较少时，一条目录对应一条 --exclude 最容易维护。下面的示例只排除项目自己的 Git 元数据、依赖目录和临时目录；日志目录则只排除其中的 .log 文件。

# 用单引号保护模式，并保留 project/ 成员名前缀
tar -czf project-backup.tar.gz \
  --exclude='project/.git' \
  --exclude='project/node_modules' \
  --exclude='project/tmp' \
  --exclude='project/logs/*.log' \
  project/

这里的四条规则范围不同：前三条针对固定目录，第四条只针对日志目录下的日志文件。如果多个项目都要排除各自的依赖目录，可以使用 --exclude='*/node_modules'，但这会扩大匹配范围；备份根目录中存在不想排除的同名目录时，应退回到完整路径模式。

不要把多个模式拼到一条参数里，也不要依赖参数出现顺序来“撤销”排除。更可靠的做法是让每条模式都表达一个明确的边界，并在归档后检查具体成员。

规则较多时用 --exclude-from 管理清单

项目有多套备份策略时，建议把排除模式单独放到文本文件。清单按一行一个模式读取，模式仍然要按 tar 看到的成员名书写；空行可以保留，但不要把当前 Shell 的补全结果复制进清单。

# exclude-project.txt：每行一个 tar 成员名模式
project/.git
project/node_modules
project/tmp
project/logs/*.log

# 让 tar 读取清单，而不是让 Shell 展开清单中的星号
tar -czf project-backup.tar.gz \
  --exclude-from=exclude-project.txt \
  project/

如果备份脚本同时处理多个根目录，清单文件可以按任务拆分，例如开发环境一份、发布产物一份。这样比在一条很长的命令里重复拼接参数更容易审阅，也方便在代码仓库中进行变更记录。

用 tar -tf 检查排除结果

排除规则写完后，不要只看命令是否返回成功。归档成功只说明 tar 创建了文件，不代表模式命中了预期目录。可以先列出成员，再搜索应该被排除的名字和应该保留的名字。

# 先列出归档成员，再分别检查排除项与保留项
tar -tzf project-backup.tar.gz | grep -E '(^|/)(\.git|node_modules|tmp)(/|$)' || true
tar -tzf project-backup.tar.gz | grep 'project/config/'

第一条没有输出通常意味着这些目录没有进入归档；第二条用于确认配置目录仍然存在。若所有路径都以 ./project/ 开头，就把规则改成对应的 ./project/... 前缀，或调整 tar 的输入根目录后再统一检查。重点不是死记某个前缀，而是让规则和实际成员名保持同一口径。

常见问题

为什么 --exclude='node_modules' 可能不是我想要的范围？

它没有明确表达项目根目录和层级边界。需要精确控制时写完整成员名前缀；需要跨项目匹配时再使用带通配符的宽模式。

排除模式为什么一定要加引号？

引号阻止当前 Shell 先展开 *、? 等字符，让 tar 获得原始模式并负责匹配。

怎么判断是模式错了还是归档前缀错了？

先运行 tar -tzf 查看实际成员名，再把成员名中的前缀原样带入 --exclude。这比反复改通配符更快。