为何我的Zsh脚本执行时出现‘bad substitution’错误？

错误原因 #

报错pathprepend:3: bad substitution的核心原因是：ARG=${!i}是Bash专属的间接扩展语法，Zsh并不支持这种写法。这段代码原本意图通过变量i的数值（比如1、2）获取对应的位置参数（$1、$2），但Zsh有自己的语法实现逻辑。

修复方案 #

将pathprepend函数里的ARG=${!i}替换为Zsh支持的写法，推荐两种直观实现方式：

方式1：利用位置参数数组索引 #

Zsh中$@是位置参数的数组，直接通过下标访问即可实现需求：

pathprepend() {
  for ((i=$#; i>0; i--));
  do
    ARG=$@[$i]  # 替换原有的ARG=${!i}
    if [ -d "$ARG" ] && [[ ":$PATH:" != *":$ARG:"* ]]; then
        PATH="$ARG${PATH:+":$PATH"}"
    fi
  done
}

方式2：使用Zsh的间接扩展语法 #

如果习惯间接引用的思路，Zsh可以用${(P)i}实现类似Bash${!i}的效果：

pathprepend() {
  for ((i=$#; i>0; i--));
  do
    ARG=${(P)i}  # 替换原有的ARG=${!i}
    if [ -d "$ARG" ] && [[ ":$PATH:" != *":$ARG:"* ]]; then
        PATH="$ARG${PATH:+":$PATH"}"
    fi
  done
}

额外优化建议 #

• 调用函数时给参数加引号：比如将pathprepend $VCPKG_ROOT改为pathprepend "$VCPKG_ROOT"，避免路径包含空格时出现解析错误。
• 利用Zsh内置特性简化逻辑：Zsh有和PATH同步的path数组，判断目录是否已在路径中可以用更简洁的if (( ! $path[(I)$ARG] ))，替代原有的字符串匹配逻辑。

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