Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】Bash Parameter Expansion: Two Quirks That Slip Through Code Reviews

2026年10月22日に「Dev.to」が公開したITニュース「Bash Parameter Expansion: Two Quirks That Slip Through Code Reviews」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

Bashスクリプトでは変数が「未設定」か「空文字」かで処理が変わる点に注意。`${var:-default}`は未設定・空文字で、`${var-default}`は未設定時のみデフォルト値を使う。また`[[ -v var ]]`は変数の有無、`[[ -n $var ]]`は値の有無を判定する。バグを防ぐため適切な記法を使おう。

ITニュース解説

システムエンジニアを目指す初心者がBashスクリプトを学ぶ上で、避けて通れないのが「変数の扱い方」だ。特に、変数の値が存在しない場合や空の場合にどう振る舞うべきかは、スクリプトの信頼性を大きく左右する。一見すると些細な違いに見えるが、これが原因で本番環境で予期せぬエラーを引き起こすケースは少なくない。今回は、Bashスクリプトでよく使われる二つのパラメータ展開と条件分岐の落とし穴について詳しく解説する。これらを理解することで、より堅牢で安全なスクリプトを書くことができるようになるだろう。

まず一つ目は、「デフォルト値を設定する際のコロンの有無」についてだ。Bashスクリプトでは、変数が未設定の場合に特定のデフォルト値を使いたい場面がよくある。このとき、${var:-default}と${var-default}という二つの書き方がある。この二つの構文は非常に似ているが、その挙動には決定的な違いがあり、この違いが多くのスクリプト開発者を悩ませてきた。

具体的に、コロンがある${var:-default}の形は、「変数varが未設定である、または 変数varが空(値がない)である」場合に、defaultというデフォルト値を使用するという意味を持つ。つまり、var=""のように変数が宣言されているがその値が空文字列の場合でも、デフォルト値が適用される。

一方、コロンがない${var-default}の形は、「変数varが未設定である」場合にのみdefaultというデフォルト値を使用するという意味になる。この場合、var=""のように変数が空文字列で設定されていると、Bashは「変数varは設定されている」と判断し、デフォルト値を使わずに、その空の値をそのまま採用してしまう。

この違いは、実際のスクリプトで大きな影響を与える。例えば、システムのホームディレクトリを指定する環境変数HOME_DIRを例に考えてみよう。もしHOME環境変数が設定されておらず、あるいは空である場合に、デフォルトで/rootというパスを使いたいとする。

安全な書き方は${HOME:-/root}となる。この場合、HOME変数が全く設定されていない場合でも、HOME=""のように空の文字列が設定されている場合でも、どちらも/rootがHOME_DIRに設定される。これにより、どのような状況でも期待通りのデフォルト値が適用される。

しかし、もし誤って${HOME-/root}と書いてしまった場合、HOME変数が全く設定されていない場合は/rootが使われるが、もしHOME=""のように空文字列が設定されていたら、HOME_DIRには/rootではなく空文字列が設定されてしまう。これは、想定外の挙動であり、その後の処理でパスが見つからないなどのエラーに繋がる可能性がある。

ほとんどの場合、変数が「未設定」の場合だけでなく、「空」の場合もデフォルト値を使いたいと考えるだろう。そのため、環境変数や設定ファイルから読み込む値のように、空である可能性も考慮する必要がある変数に対してデフォルト値を設定する際は、コロンを含む${var:-default}の形を使うのがより堅牢で推奨される方法だ。

次に二つ目の落とし穴は、「変数の状態をチェックする際の[[ -v var ]]と[[ -n $var ]]の違い」だ。Bashスクリプトでは、特定の変数が存在するかどうか、あるいはその値が空ではないか、といった条件に基づいて処理を分岐させたい場面が頻繁に現れる。ここで[[ -v var ]]と[[ -n $var ]]という二つの条件式が使われるが、これもまた、その挙動の違いを理解しておくことが非常に重要だ。

[[ -v var ]]という条件式は、「varという名前の変数が宣言されているか、つまり存在するか」をチェックする。Bashのバージョン4.2以降では、変数が宣言されていて非空であるかを確認する意味も含むが、基本的な意味合いとしては「変数varが存在するか」だ。例えば、var=""のように変数が宣言されていて値が空文字列の場合でも、[[ -v var ]]は「真(true)」と評価される。なぜなら、varという変数は存在しているからだ。

一方で、[[ -n $var ]]という条件式は、「変数varの展開結果が非空であるか、つまり値が空ではないか」をチェックする。$varは変数varの値を意味するので、この条件式は「varの値が空文字列ではないか」を問うていることになる。もしvar=""のように変数が宣言されていて値が空文字列の場合、$varは空文字列に展開されるため、[[ -n $var ]]は「偽(false)」と評価される。これは、変数varが空の値を保持しているため、非空ではないと判断されるからだ。[[ -n "$var" ]]のようにダブルクォーテーションで囲んでも結果は変わらない。

この違いは、スクリプトでオプションのフラグが渡されたかどうかをチェックする際に特に重要になる。例えば、冗長な出力を行う「verboseモード」を有効にするVERBOSEというフラグがあるとする。このVERBOSEフラグは、存在すれば有効だが、値自体は空の場合もある。

もしVERBOSE=""のように、フラグが渡されたが値は空の場合、[[ -v VERBOSE ]]は「真」と評価され、「verboseモード」が正しく検出される。これは、VERBOSEという変数が存在しているためだ。

しかし、もし[[ -n $VERBOSE ]]を使ってしまうと、VERBOSE=""の場合、$VERBOSEが空文字列に展開されるため、「偽」と評価されてしまい、せっかく渡された「verboseモード」の指定を見逃してしまうことになる。これでは、ユーザーが意図した通りの挙動にならない。

したがって、「変数が存在するかどうか、つまり宣言されているかどうか」をチェックしたい場合は[[ -v var ]]を、「変数が空ではない具体的な値を持っているかどうか」をチェックしたい場合は[[ -n $var ]](または「空であるかどうか」をチェックする[[ -z $var ]])を使用するのが正しい使い分けとなる。

これらの二つのケースから得られる実践的な教訓は、Bashスクリプトで設定値や環境変数を扱う際に、より「防御的な」選択をすることが重要だということだ。つまり、曖昧さや予期せぬ挙動を排除し、どのような状況でもスクリプトが意図した通りに動作するように配慮する。

具体的には、デフォルト値を設定する際には${var:-default}というコロンを含む形を、変数が宣言されているか(つまり存在するか)をチェックする際には[[ -v var ]]を使用することを推奨する。これらは、変数が空文字列である場合も考慮に入れ、スクリプトの意図をより明確にし、多くのBashバージョンで一貫した挙動を期待できる。

これらの小さな違いを理解し、適切に使いこなすことは、システムエンジニアとして信頼性の高いスクリプトを書くための第一歩となる。コードレビューでも見落とされがちなポイントだからこそ、個々の開発者が意識して習得し、堅牢なシステム構築に役立ててほしい。

関連コンテンツ