BusyBox ash shell 脚本与 bash 语法不兼容排查

最常见的语法差异

双括号条件判断 [[ ]]

# ❌ bash 写法
if [[ "$VALUE" == *"test"* ]]; then
  echo "contains test"
fi

# ✅ POSIX sh 写法（ash 兼容）
case "$VALUE" in
  *test*) echo "contains test" ;;
esac

# 或
if echo "$VALUE" | grep -q "test"; then
  echo "contains test"
fi

数组

# ❌ bash 写法
arr=(a b c)
echo "${arr[0]}"
echo "${#arr[@]}"

# ✅ ash 不支持数组，用逗号分隔的字符串模拟
arr="a,b,c"
echo "$arr" | busybox cut -d',' -f1
echo "$arr" | busybox tr ',' '\n' | busybox wc -l

== vs = 字符串比较

# ❌ bash 接受 ==
if [ "$a" == "$b" ]; then
  ...
fi

# ✅ POSIX sh 只认 =
if [ "$a" = "$b" ]; then
  ...
fi
# ash 在某些版本里也接受 ==，但不推荐依赖

echo 的 -e 标志

# ❌ GNU echo 的 -e 启用转义（某些 ash 版本不支持）
echo -e "line1\nline2"

# ✅ 用 printf 代替（标准、行为一致）
printf "line1\nline2\n"

# 或
printf '%s\n' "line1" "line2"

${BASH_SOURCE} / ${BASH_LINENO}

# ❌ bash 专有变量
echo "Script: ${BASH_SOURCE[0]}"
echo "Line: $BASH_LINENO"

# ✅ ash 用 $0（脚本路径），没有直接的行号变量
echo "Script: $0"
# 行号需要手动维护

字符串替换 ${var/pattern/replacement}

# ❌ ash 不支持这个（这是 bash 特有展开）
name="hello world"
echo "${name/world/busybox}"

# ✅ 用 sed 替代
name="hello world"
echo "$name" | busybox sed 's/world/busybox/'

$() vs 反引号

# ✅ ash 支持 $()，这是 POSIX 标准，和 bash 一样
result=$(cat file.txt)

# ✅ 反引号也支持，但不推荐（嵌套时容易出错）
result=`cat file.txt`

read 命令差异

# ❌ ash 的 read 不支持很多 bash 特有选项
# read -p "prompt: " var  ← ash 不支持 -p
# read -n 3 var            ← ash 不支持 -n

# ✅ ash 兼容写法
printf "prompt: "
read var

# 只读取前 3 个字符
var=$(read input && echo "$input" | busybox cut -c1-3)

完整兼容性检查清单

在把脚本从 GNU/bash 环境搬到 BusyBox/ash 之前，逐项检查：

• [ ] shebang 是 #!/bin/sh 而不是 #!/bin/bash 或 #!/usr/bin/env bash
• [ ] 没有 [[ ]] 双括号（ash 不支持）
• [ ] 没有数组和关联数组
• [ ] 没有 ${var/pattern/repl} 字符串替换
• [ ] 没有 ${BASH_SOURCE}、${FUNCNAME} 等 bash 专有变量
• [ ] echo 没用 -e（改用 printf）
• [ ] 字符串比较用 = 而不是 ==
• [ ] read 没用 bash 专有选项（-p、-n、-s 等）
• [ ] 没有 source（ash 用 .）
• [ ] 没有 function 关键字（ash 用 funcname() { ... }）
• [ ] 没有 let 算术（ash 用 $(( expr ))）
• [ ] 没有 select 循环
• [ ] 没有 trap 复杂功能（ash trap 基础支持，但部分信号处理不同）

快速验证

# 模拟 ash 运行脚本，观察报错
busybox ash -x your_script.sh
# -x 会打印每一行执行的命令，方便定位是哪一行报 syntax error

# 检查脚本语法（不实际执行）
busybox ash -n your_script.sh
# 有语法错误会打印行号和错误信息

实用替代方案

如果你的脚本确实大量依赖 bash 特性，有三条路：

1. 改写脚本：用上面的对照表改成 POSIX sh 兼容写法（推荐）
2. 开启 BusyBox hush：hush 比 ash 多一些 bash 语法支持（如 [[ ]]、数组），但仍不是完整 bash
3. 在 BusyBox 里额外装 bash：静态编译 bash（约 1MB），代价是增加体积但脚本直接能用

在嵌入式场景，方案 1 最推荐——POSIX sh 兼容的脚本可以在任何 shell 下运行，维护成本最低。