
rsync --exclude=build 看起来像是只排除源目录里的 build。但在本机样例里,src/build 和 src/sub/build 都没有进入目标。模式没有写路径前缀时,匹配会落到树里各层相同名称上。只想跳过根目录产物时,少一个斜杠,结果就会多排掉一层。
这里用的是 macOS 自带的 /usr/bin/rsync,版本信息显示为 openrsync,兼容 rsync 协议 29。测试树包含根目录的 build、sub/build,还在更深一层留了 w/build。命令都在临时目录执行,比较的是目标目录最后留下的路径。
==== 6. --exclude 匹配的口径 ====
$ find ex -print
ex
ex/sub
ex/sub/deep
ex/sub/keep.txt
ex/sub/build
ex/sub/build/junk2.txt
ex/sub/deep.log
ex/notes.log
ex/build
ex/build/junk1.txt
ex/w
ex/w/build
$ rsync -r --exclude=build ex/ ex_a/
退出码 0
$ find ex_a -print
ex_a
ex_a/sub
ex_a/sub/deep
ex_a/sub/keep.txt
ex_a/sub/deep.log
ex_a/notes.log
ex_a/w
$ rsync -r --exclude=build/ ex/ ex_b/
退出码 0
$ find ex_b -print
ex_b
ex_b/sub
ex_b/sub/deep
ex_b/sub/keep.txt
ex_b/sub/deep.log
ex_b/notes.log
ex_b/w
ex_b/w/build
$ rsync -r --exclude=/build ex/ ex_c/
退出码 0
$ find ex_c -print
ex_c
ex_c/sub
ex_c/sub/deep
ex_c/sub/keep.txt
ex_c/sub/build
ex_c/sub/build/junk2.txt
ex_c/sub/deep.log
ex_c/notes.log
ex_c/w
ex_c/w/build
$ rsync -r --exclude=sub/build ex/ ex_d/
退出码 0
$ find ex_d -print
ex_d
ex_d/sub
ex_d/sub/deep
ex_d/sub/keep.txt
ex_d/sub/deep.log
ex_d/notes.log
ex_d/build
ex_d/build/junk1.txt
ex_d/w
ex_d/w/build
$ rsync -r --exclude='*.log' ex/ ex_e/
退出码 0
$ find ex_e -print
没写斜杠,匹配会走到哪一层?
--exclude=build 将树里的同名项都挡住。实测目标 ex_a 中,build、sub/build 和 w/build 均未出现。模式不以斜杠开头时,不是「只看源目录的第一层」,因此它适合排除任意深度都不想保留的同名目录,却不适合只清理根目录生成物的情况。
模式末尾加 /,表示只匹配目录。日志里的 --exclude=build/ 留下 w/build,因为它是一个普通文件;根目录和 sub 下面的 build 目录仍然被排除。这里容易误会成「加了斜杠后只看当前目录」,实际改变的是类型条件,不是把规则锚定到传输根。
/build 为什么只管根目录?
模式开头的 / 把匹配位置锚定在传输树的根。测试的 --exclude=/build 只去掉根目录的 build,sub/build 和 w/build 仍保留。这里的根是 rsync 正在传输的源树根,不是机器文件系统的 /,也不是命令所在的当前目录。日志以 ex/ 作为源参数,所以 /build 对应的是 ex/build;若源参数改成另一个子目录,锚定位置也随之变化。写规则时应先确定实际传输树从哪里开始,再判断开头的斜杠会把模式固定在哪个位置。
本地结果也能看出模式并不要求只能是一个目录名。sub/build 把匹配范围进一步收窄到特定的相对路径;*.log 则能匹配不同目录中的同后缀文件。/build 不是给路径加上机器上的绝对位置,sub/build 也不需要包含临时测试目录的完整名称。模式写的是传输树里的路径结构,命令用的源目录决定了这棵树的边界。
这三个写法适用的意图不同:build 用于各层同名项,build/ 用于各层同名目录,/build 用于源树根部的同名项。若目标是排掉根部目录且不碰深层目录,/build 更贴近需求;若希望无论在哪一层都不传 build 目录,则 build/ 更明确。把规则对准相对路径,比把整个源目录名塞进模式里更容易复用,也不容易在换工作目录后失效。
日志还试了 --exclude=sub/build,目标只留下根部 build 和 w/build,sub/build 不见了。换成 --exclude='*.log' 后,根部的 notes.log 和子目录中的 deep.log 都被排掉。星号可以覆盖不同目录层级里的文件名;这和把规则锚在根目录是两种不同写法。模式里写了目录路径,匹配的就是树内的相对路径,不需要把绝对临时目录名拼进去。
日志中的引号也有作用:--exclude='*.log' 把星号作为参数交给 rsync,避免 shell 先按当前目录的文件名展开它。若当前目录没有匹配文件,某些 shell 会把星号原样传下去;目录里有匹配项时,传给程序的内容则可能变成一串文件名。单引号让命令里的通配符含义保持稳定,匹配由 rsync 在源树上完成。
我会先把模式写窄,再用 --dry-run 看传输清单。排除规则本身通常不提醒「范围比预想大」;目标目录里少几个文件时,检查最终树才知道误伤发生在哪一层。
排除规则不负责删除目标旧文件
源树里某个路径被排除,不代表目标里同名内容会自动消失。另一个本地样例先在目标里放入 extra.txt 和 onlydir/,再执行不带 --delete 的同步;它们仍留在目标。加上 --delete 后,才看到额外文件和空目录被移除。排除规则决定本次传输不考虑哪些源路径,删除策略决定目标端独有项怎么处理,两者不是一个开关。
带删除选项时先看干跑输出。该日志中 rsync -av --dry-run --delete 列出了将删除的路径,干跑后目标内容仍在;移除 --dry-run 再执行,目标才变成与源同步的样子。确认清单之前,不要把真实目录直接交给带删除选项的命令。
这些模式的细节来自本机 openrsync 样例,其他系统上的 rsync 版本没有在这次测试里逐一比较。实际同步前,先确认命令用的源根,再用干跑检查哪些路径会被排除或删除。若只想忽略根部生成目录,就把 / 放在模式前面,不要把深层同名目录也顺手屏蔽掉。