为何Zsh脚本中同一条命令与直接执行时的解释不同？

问题场景 #

我写了一个安装Poetry的Zsh脚本，遇到了参数解析异常的问题：同一条命令在脚本里执行和直接在Zsh中执行结果完全不同。

脚本片段：

#!/bin/zsh
set -x
INSTALL_SPECIFIC_VERSION="--version 1.6.1"
# 为何此命令无法工作？
echo "curl -sSL URL | python3 - $INSTALL_SPECIFIC_VERSION"
# 输出内容：
# curl -sSL URL | python3 - --version 1.6.1
curl -sSL URL | python3 - "$INSTALL_SPECIFIC_VERSION"
# 我使用的可行修复方案，但不清楚原因：
# curl -sSL URL | python3 - $(printf "%s" "$INSTALL_SPECIFIC_VERSION")
set +x

执行脚本时的报错结果：

➜  /usr/bin/zsh test_script.zsh
+test_script.zsh:3> INSTALL_SPECIFIC_VERSION='--version 1.6.1'
+test_script.zsh:5> echo 'curl -sSL URL | python3 - --version 1.6.1'
curl -sSL URL | python3 - --version 1.6.1
+test_script.zsh:8> curl -sSL URL
+test_script.zsh:8> python3 - '--version 1.6.1'
usage: - [-h] [-p] [--version VERSION] [-f] [-y] [--uninstall] [--path PATH] [--git GIT]
-: error: unrecognized arguments: --version 1.6.1
+test_script.zsh:9> set +x

但直接在Zsh中执行echo输出的命令却能正常运行：

➜  /usr/bin/zsh -c "curl -sSL URL | python3 - --version 1.6.1"
Retrieving Poetry metadata

The latest version (1.6.1) is already installed.

我找到的临时修复方案是用命令替换：

curl -sSL URL | python3 - $(printf "%s" "$INSTALL_SPECIFIC_VERSION")

核心原因 #

问题出在Shell的分词机制上：

• 当你用双引号包裹变量"$INSTALL_SPECIFIC_VERSION"时，Zsh会把变量里的整个字符串--version 1.6.1当作单个参数传给python3 -。此时Python脚本收到的是一个完整的字符串参数，无法识别成--version选项加对应版本值，所以报错。
• 而直接在命令行输入命令，或者使用$(printf "%s" "$INSTALL_SPECIFIC_VERSION")这种命令替换时，Zsh会对变量内容做分词处理，把空格作为分隔符，将字符串拆成--version和1.6.1两个独立参数传给Python脚本，这样就能被正确识别。

更可靠的解决方案 #

用数组存储多参数是Shell中处理这类场景的标准做法，比命令替换更安全（能兼容参数含空格的情况）：

#!/bin/zsh
set -x
# 用数组存储每个独立参数
INSTALL_SPECIFIC_VERSION=(--version 1.6.1)
curl -sSL URL | python3 - "${INSTALL_SPECIFIC_VERSION[@]}"
set +x

这里"${INSTALL_SPECIFIC_VERSION[@]}"会将数组的每个元素作为独立参数展开，完美还原你直接执行命令时的参数结构。

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