为何Bash脚本中rsync的--exclude参数失效，命令行执行却正常？

核心原因 #

• Bash对引号的解析发生在参数扩展之前：当你把带引号的参数拼接进字符串变量时，变量内部的引号只会被当成普通字面字符，不会被shell识别为参数边界的界定符。
• 你给--exclude的参数值加引号后，rsync实际收到的排除规则会包含多余的引号字符：比如你写--exclude='$ex'，若$ex为builds，rsync收到的排除规则是'builds'（带单引号），自然无法匹配到实际名为builds的文件，导致排除规则完全失效。
• 命令行直接执行时引号生效的原因：shell在解析直接输入的命令行时，会先处理引号、剥除作为界定符的引号后再执行命令，rsync收到的是不带多余引号的正常规则。

你最初不加引号拼接EXCEPTIONS="$EXCEPTIONS --exclude=$ex"能正常工作，只是因为你的排除规则没有特殊字符和空格，一旦$ex包含空格、通配符就会出现拆分错误，属于不稳定的写法。

测试脚本结果符合预期的原因 #

你写的testar.sh是直接把带引号的参数写在命令行中，shell解析脚本命令时就已经完成了引号剥离，自然和命令行执行结果一致。如果把参数存入变量后再展开就能复现问题，示例如下：

#!/bin/bash
# 将带引号的参数存入变量再展开，即可复现引号字面化问题
args="-arqu --exclude='dshul' --exclude='RegressionTest' --exclude='builds' odashare2/QA/ share/QA"
./test.sh $args

运行后你会看到输出的参数中--exclude的值带有单引号，和直接写在命令行的结果完全不同。

正确的动态参数构建方案 #

不要用字符串拼接的方式构建动态参数，Bash数组可以完美保留参数边界，适配所有包含特殊字符、空格的参数场景：

# 1. 初始化空的排除规则数组
EXCEPTIONS=()
# 2. 循环读取配置时添加排除规则
for ex in "${your_exception_list[@]}"; do
  EXCEPTIONS+=(--exclude="$ex")
done
# 3. 执行rsync时展开数组，引号会被正确处理
rsync -aus --no-verbose "${EXCEPTIONS[@]}" "$SOURCEDIR/$backup_path/" "$SYNCTODIR/$backup_path"

内容的提问来源于stack exchange，提问作者wsdx