Bash脚本检查参数是否以--开头失败的问题排查与修复

原test.sh脚本内容：

#!/bin/bash

echo -e "Args: [$@]"

if [[ "${$@:0:2}" == "--" ]]
then
    echo -e "Args starts with --: [$@]"
else
    echo -e "Args does not start with --: [$@]"
fi

测试命令：

./test.sh "--hello --many --args --here --must --starts --with"
./test.sh "world"

执行输出：

root@test:~# ./test.sh "--hello --many --args --here --must --starts --with"
Args: [--hello --many --args --here --must --starts --with]
./test.sh: line 5: ${$@:0:2}: bad substitution
root@test:~# ./test.sh "world"
Args: [world]
./test.sh: line 5: ${$@:0:2}: bad substitution
root@test:~# 

问题原因 #

脚本触发bad substitution错误的核心原因是${$@:0:2}的写法不符合Bash语法：

• $@是Bash内置的特殊变量，用于指代所有位置参数，它并非普通变量名，不能直接套用${变量名:起始位置:长度}的字符串截取语法。
• 从测试场景来看，实际需求应该是检查第一个传入参数是否以--开头，而非对所有参数的集合做截取判断。

修复方案 #

根据不同的需求，提供两种修复方式：

1. 检查第一个参数是否以--开头 #

如果需求是验证第一个传入参数的前缀是否为--，修改脚本的判断逻辑即可：

#!/bin/bash

echo -e "Args: [$@]"

# 针对第一个位置参数$1做前缀判断
if [[ "${1:0:2}" == "--" ]]
then
    echo -e "First arg starts with --: [$1]"
else
    echo -e "First arg does not start with --: [$1]"
fi

执行测试：

• 运行./test.sh "--hello --many..."，会输出First arg starts with --: [--hello --many --args --here --must --starts --with]
• 运行./test.sh "world"，会输出First arg does not start with --: [world]

2. 检查所有参数中是否存在以--开头的项 #

如果需要判断所有传入参数里是否有任意一项以--开头，可以通过循环遍历实现：

#!/bin/bash

echo -e "Args: [$@]"

has_dash_prefix=false
# 遍历所有位置参数
for arg in "$@"
do
    if [[ "${arg:0:2}" == "--" ]]
    then
        has_dash_prefix=true
        break
    fi
done

if $has_dash_prefix
then
    echo -e "At least one argument starts with --"
else
    echo -e "No arguments start with --"
fi

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