Bash脚本传递含空格参数时如何保留转义字符？

我帮你理清这个Bash参数传递的问题——你遇到的核心是Shell的单词拆分规则在搞鬼：直接调用脚本时，Shell能正确解析带转义、单引号或双引号的路径，把整个--path=/path/to/a folder with spaces当作单个参数；但通过辅助脚本传递时，如果处理不当，空格会被当成参数分隔符，把原本的单个参数拆成好几段。

先看你的示例脚本，里面的printf "%s\n" $@和echo $@没有用双引号包裹$@，这就触发了Shell的单词拆分，所以你才会看到参数被拆成多行输出。而正确的做法是始终用双引号包裹$@，这样才能保留每个参数的完整性。

为什么直接调用没问题？ #

当你用以下方式直接调用脚本时：

./so_example.sh --path=/path/to/a\ folder\ with\ spaces
./so_example.sh --path='/path/to/a folder with spaces'
./so_example.sh --path="/path/to/a folder with spaces"

Shell在执行脚本前就完成了解析，把--path=/path/to/a folder with spaces打包成单个完整参数传递给$@，所以用"$@"就能正确保留这个参数的原样。

辅助脚本传递参数的正确姿势 #

如果你要写辅助脚本来调用目标脚本，关键就是传递参数时用双引号包裹$@，确保每个参数（哪怕含空格或特殊字符）都被当作整体传递。

比如写个辅助脚本helper.sh：

#!/usr/bin/env bash
# 正确传递参数的方式：用"$@"保留每个参数的完整性
./so_example.sh "$@"

当你用以下方式调用这个辅助脚本时：

./helper.sh --path='/path/to/a folder with spaces'
# 或者
./helper.sh --path="/path/to/a folder with spaces"
# 或者
./helper.sh --path=/path/to/a\ folder\ with\ spaces

目标脚本so_example.sh都会收到完整的单个参数，不会被拆分。

修正你的示例脚本 #

把你的so_example.sh改成只保留正确的参数打印方式：

#!/usr/bin/env bash
set -x
# 正确用法：双引号包裹$@，保留参数完整性
printf "%s\n" "$@"
echo "$@"
echo -e "$@"

此时不管是直接调用还是通过辅助脚本调用，输出都会是完整的单个参数：

+ printf '%s\n' '--path=/path/to/a folder with spaces'
--path=/path/to/a folder with spaces
+ echo '--path=/path/to/a folder with spaces'
--path=/path/to/a folder with spaces
+ echo -e '--path=/path/to/a folder with spaces'
--path=/path/to/a folder with spaces

避坑指南 #

• 别直接传未加引号的变量：比如./so_example.sh $path，如果path里有空格，会被拆成多个参数；正确写法是./so_example.sh "$path"。
• 别手动加多余的引号/转义：比如./so_example.sh "--path='$path'"，这会把单引号也当作参数的一部分，反而让目标脚本解析出错。
• 永远用"$@"代替$@：$@会触发单词拆分，而"$@"会严格保留每个参数的原始状态（包括空格、特殊字符等）。

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