Bash「bad substitution」の原因と直し方
bad substitution は、bash の書き方を sh(dash)で実行したときによく出る。
sh ではなく bash で実行すれば直る。
bash 自身が出すときは、波かっこの中の書き方の誤りか、古い bash が知らない書き方である。
公開:
要約
シェルスクリプトが次の行で止まることがある。
前者が bash、後者が dash(Debian・Ubuntu の /bin/sh)の出し方である。
script.sh: line 2: ${x.y}: bad substitution
script.sh: 2: Bad substitutionbad substitution は、${...} の中身をそのシェルが解釈できなかったという意味である。
いちばん多いのは、bash の書き方を sh で実行した場合である。sh ではなく bash で実行すれば直る。
解決策
1. bash で実行する
bash script.sh./script.sh で実行するなら、1 行目を #!/bin/bash にする。sh script.sh と打つと 1 行目は読まれず、sh がそのまま使われる。
cron や CI で呼ぶときも、sh を付けていないかを見る。
2. Dockerfile では SHELL で bash に替える
SHELL ["/bin/bash", "-c"]
RUN v=1.2.3 && echo "${v//./-}"SHELL を書いた行より後の RUN が bash で動く。
3. 波かっこの中を正しく書く
name="$(date +%Y)"
echo "${name}"コマンドの結果は $(...) で変数に入れてから ${name} で展開する。
波かっこの中に書けるのは変数名と、Shell Parameter Expansion(新しいタブで開く) にある記号だけである。
4. 古い bash では別の書き方にする
bash --version
echo "$x" | tr '[:lower:]' '[:upper:]'4.0 より古い bash しか使えない環境では、tr で変換すれば ${x^^} と同じ結果になる。
よくある原因
shで実行している。
Debian 12 のコンテナでsh script.shを打つと、/bin/shの実体は dash だった。${x:0:2}(部分文字列)・${x/l/L}(置換)・${x^^}(大文字化)はどれも bash の機能で、dash は最初の 1 つでBad substitutionを出し、終了コード 2 で止まった。
同じファイルをbashで実行すると、3 行とも通った。- Dockerfile の
RUNで bash の書き方を使っている。
シェル形式のRUNは、Linux では/bin/sh -cで動く(Dockerfile reference(新しいタブで開く))。
debian や ubuntu のイメージでは、これも dash である。 - 波かっこの中の書き方を誤っている。
${ x}(波かっこの直後の空白)・${x.y}(名前に使えない.)・${$(date)}(コマンド置換を波かっこで包む)は、bash 5.2 でもbad substitutionになった。 - 古い bash を使っている。
大文字・小文字を変える${x^^}と${x,,}は Bash 4.0 で加わった(Bash NEWS(新しいタブで開く))。
macOS に入っている/bin/bashは 3.2 系である。