Bash でコマンド置換＋ヒアドキュメントを使った際に「warning: command substitution: 1 unterminated here-document」が発生した場合の対策です。

この警告は、ヒアドキュメント全体もコマンド置換内(のサブシェル内)に記述することで回避できます。

VAL1="Any Value"
RESULT=$(cat << _EndOfJson_
{
  "foobar1": "${VAL1}"
}
_EndOfJson_
)
echo "$RESULT"
#=> {
#=>   "foobar1": "Any Value"
#=> }

catとパイプを使う場合

VAL1="Any Value"
RESULT=$(cat << _EndOfJson_
{
  "foobar1": "${VAL1}"
}
_EndOfJson_
)
#=> {
#=>   "foobar1": "Any Value"
#=> }

解説

やりがちなのが以下のような記述です。

warningが発生する例

VAL1="Any Value"
RESULT=$(cat << _EndOfJson_)
{
  "foobar1": "${VAL1}"
}
_EndOfJson_
#=> warning: command substitution: 1 unterminated here-document が発生
# ちなみに、コマンド自体はなんとなく実行される

ほとんど似ていますが、コマンド置換 $() のカッコの位置が異なることがポイントです。

$(cat << _EndOfJson_) は、サブシェル(子プロセス)で実行されます。しかし、このカッコ内 _EndOfJson_ という終端行がありません。これが warning の発生理由です。

こういったこともあり、手で１行づつ入力すると $(cat << _EndOfJson_) という行の時点で warning が発生します。
※ しかし、warning が出てもなんとなく動いちゃう（理由は追ってない）ので、困りもの...

対策の方は、$RESULT 視点では RESULT=$(...) となっており、$(...) 内にヒアドキュメントの終端が含まれているため、警告が出ないのです。

あとがき

GPT-4o モデルに curl コマンドで画像をプロンプトとして送信する方法を書いてたら、ほとんどシェル芸の話だったことに気が付いたので、分割しました。

EoT