できない.dev

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 substitution

bad 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^^} と同じ結果になる。

よくある原因

  1. sh で実行している。
    Debian 12 のコンテナで sh script.sh を打つと、/bin/sh の実体は dash だった。
    ${x:0:2}(部分文字列)・${x/l/L}(置換)・${x^^}(大文字化)はどれも bash の機能で、dash は最初の 1 つで Bad substitution を出し、終了コード 2 で止まった。
    同じファイルを bash で実行すると、3 行とも通った。
  2. Dockerfile の RUN で bash の書き方を使っている。
    シェル形式の RUN は、Linux では /bin/sh -c で動く(Dockerfile reference(新しいタブで開く))。
    debian や ubuntu のイメージでは、これも dash である。
  3. 波かっこの中の書き方を誤っている。
    ${ x}(波かっこの直後の空白)・${x.y}(名前に使えない .)・${$(date)}(コマンド置換を波かっこで包む)は、bash 5.2 でも bad substitution になった。
  4. 古い bash を使っている。
    大文字・小文字を変える ${x^^} と ${x,,} は Bash 4.0 で加わった(Bash NEWS(新しいタブで開く))。
    macOS に入っている /bin/bash は 3.2 系である。