シェルスクリプトの終了ステータス $?とexitコード一覧・判定方法

終了ステータスとは、コマンドが終わるときにシェルへ返す0〜255の整数で、0が「成功」、0以外が「成功しなかった」を表します。 直前のコマンドの値は特殊変数 $? に入り、if、&&、|| はすべてこの値を見て次の動きを決めています。

この記事では、0・1・2・126・127・128+n・130・137・143・255 の意味を、その値を実際に出せる再現コマンドつきの一覧表にまとめました。あわせて、$? が次のコマンドで上書きされる様子、&& と || をつないだときの評価順、パイプでの PIPESTATUS と set -o pipefail、set -e で止まらないケース、関数の return と exit の違い、256以上を指定したときの値を、bash 5.2.21（Ubuntu 24.04）で実行した結果とともに示します。

終了ステータスの早見表（exitコード一覧と再現コマンド）

「再現コマンド」はすべて実行して、表の値になることを確かめています。

$? の基本：直前のコマンドの結果を読む

ls /etc/hostname
echo $?

ls /nonexistent
echo $?

/etc/hostname
0
ls: cannot access '/nonexistent': No such file or directory
2

$? は「直前に実行した1つのコマンド」の終了ステータスです。値の意味は基本的にコマンドごとに決まっていて、共通しているのは 0 が成功、0以外が成功以外 という点だけです。たとえば grep は次のように3通りを使い分けます。

grep -q root /etc/passwd
case $? in
  0) echo "見つかった" ;;
  1) echo "見つからない" ;;
  *) echo "grep 自体のエラー" ;;
esac

見つかった

「1 だから異常」とは限らないので、コマンドごとの意味は man の EXIT STATUS の節で確かめるのが確実です。diff も「差分あり」で 1 を返します（diff <(echo a) <(echo b) で 1 になることを確認しました）。

126 と 127 の違い

よく似た2つですが、原因が違います。

$ nosuchcmd
bash: line 1: nosuchcmd: command not found
=> 127

$ ./noexec.sh
bash: line 1: ./noexec.sh: Permission denied
=> 126

$ /tmp
bash: line 1: /tmp: Is a directory
=> 126

cron や CI で「手元では動くのに 127 になる」ときは、PATH が対話シェルと違っていることが多く、コマンドをフルパスで書くと解消します。

128+n：シグナルで終了したとき

プロセスがシグナルで終了すると、bash は 128 にシグナル番号を足した値を終了ステータスにします。

$ sleep 5 & kill -INT $!; wait $!
=> 130

$ sleep 5 & kill -KILL $!; wait $!
bash: line 1:  3027 Killed                  sleep 5
=> 137

$ sleep 5 & kill -TERM $!; wait $!
=> 143

終了ステータスからシグナル名を調べるには kill -l が使えます。

$ kill -l 137; kill -l 143; kill -l 130
KILL
TERM
INT

これを使うと、「シグナルで終わったかどうか」をスクリプトで判定できます。

sleep 30 & pid=$!
kill -9 $pid
wait $pid 2>/dev/null
rc=$?
if [ $rc -gt 128 ]; then
  echo "シグナル $((rc-128)) ($(kill -l $rc)) で終了"
fi

シグナル 9 (KILL) で終了

timeout は少し特別で、制限時間で打ち切ると 124 を返します。ただし timeout -s KILL 1 sleep 5 のように KILL を送る指定では 137 になりました。

$? は次のコマンドで上書きされる

$? を扱うときに最もつまずきやすい点です。echo も [ ] も1つのコマンドなので、実行した時点で $? はそのコマンドの結果に置き換わります。

ls /nonexistent 2>/dev/null
echo "1回目: $?"
echo "2回目: $?"

ls /nonexistent 2>/dev/null
if [ $? -ne 0 ]; then echo "if の中: $?"; fi

1回目: 2
2回目: 0
if の中: 0

2回目の $? は「1回目の echo が成功した」ことを表す 0 です。if の中でも、[ $? -ne 0 ] という判定自体が成功したので 0 になっています。値をあとで使うなら、直後に変数へ移します。

ls /nonexistent 2>/dev/null
rc=$?
echo "rc=$rc"; echo "まだ rc=$rc"

rc=2
まだ rc=2

終了ステータスで分岐する：if・&&・|| の書き方

if にコマンドを直接書く

if の後ろには条件式ではなくコマンドを書きます。[ ... ] も実は [ というコマンドです。そのため、次の2つは同じ意味で、後者のほうが短く、$? の上書きも起きません。

# 直す前：$? を経由する
grep -q zzz /etc/hostname
if [ $? -ne 0 ]; then
  echo "含まれていない"
fi

# 直した後：コマンドを直接書く
if ! grep -q zzz /etc/hostname; then
  echo "含まれていない"
fi

含まれていない

エラーのときの値も使いたい場合は、else の先頭で受け取ります。

cmd() { return 2; }
if cmd; then
  echo "成功"
else
  echo "else: $?"
fi

else: 2

&& と || の評価順

A && B は「A が 0 なら B を実行」、A || B は「A が 0 以外なら B を実行」です。&& と || は優先順位が同じで、左から順に評価されます。 つないだときの結果を実際に確かめました。

true  && echo A || echo B
false && echo A || echo B
true  && false  || echo "C"
false || echo D && echo E
true  || echo F && echo G
false || false  && echo J; echo "status=$?"

A
B
C
D
E
G
status=1

3行目が要注意です。A && B || C は if-else の省略形のように見えますが、B が 0 以外を返すと C も実行されます。B が必ず成功する（echo など）場合だけ省略形として使い、それ以外は if で書くと意図どおりになります。

# 省略形として使える（echo はまず成功する）
[ -f config.yml ] && echo "あり" || echo "なし"

# B が成功しない可能性があるなら if で書く
if [ -d work ]; then
  rm -r work
else
  echo "work はありません"
fi

! は終了ステータスを反転します。! false は 0、! true は 1 になりました。

パイプの終了ステータス：PIPESTATUS と pipefail

パイプでつないだとき、$? に入るのは一番右のコマンドの値だけです。

false | true; echo "false | true => $?"

false | true => 0

左側の結果も知りたいときは、bash の配列変数 PIPESTATUS を使います。パイプの各コマンドの値が左から順に入っています。

ls /nonexistent 2>/dev/null | sort | wc -l
echo "PIPESTATUS=${PIPESTATUS[*]}"

0
PIPESTATUS=2 0 0

PIPESTATUS も $? と同じく、次のコマンドで上書きされます。 間に echo を1つ挟むと、その echo の結果（要素1つ）に変わりました。

ls /nonexistent 2>/dev/null | sort | wc -l; echo "x"; echo "echo後: ${PIPESTATUS[*]}"

0
x
echo後: 0

複数の値を使うなら、直後に配列ごとコピーします。

ls /nonexistent 2>/dev/null | sort | wc -l
st=("${PIPESTATUS[@]}")
echo "ls=${st[0]} sort=${st[1]} wc=${st[2]}"

0
ls=2 sort=0 wc=0

set -o pipefail でパイプ全体の結果にする

set -o pipefail を有効にすると、パイプの $? が「0 以外を返したコマンドのうち、一番右のものの値」になります。全部が 0 のときだけ 0 です。

set -o pipefail
false | true;                         echo "false | true => $?"
ls /nonexistent 2>/dev/null | sort | wc -l; echo "ls | sort | wc => $?"
exit 3 | exit 5 | true;               echo "3 | 5 | 0 => $?"

false | true => 1
0
ls | sort | wc => 2
3 | 5 | 0 => 5

pipefail には1つ知っておきたい動きがあります。head のように途中で読むのをやめるコマンドを右に置くと、左のコマンドが SIGPIPE（141）で終わり、パイプ全体が 141 になります。

set -o pipefail
yes | head -1 >/dev/null; echo "yes | head -1 => $? (${PIPESTATUS[*]})"

yes | head -1 => 141 (141 0)

これは処理としては期待どおりなので、該当する行だけ || true を付けるか、PIPESTATUS で 141 を許容する判定にすると扱いやすくなります。

なお、Ubuntu の /bin/sh は dash で、PIPESTATUS は使えません（sh -c 'echo ${PIPESTATUS[0]}' は Bad substitution になりました）。PIPESTATUS を使うスクリプトは1行目を #!/bin/bash にします。

set -e で止まるケースと止まらないケース

set -e は「コマンドが 0 以外を返したら、その場でスクリプトを終える」設定です。ただし、終了ステータスが「判定に使われている」位置では止まりません。 1つずつ実行した結果が次の表です（「到達」は、その後ろの echo "到達" が実行されたかどうか）。

$ bash -c 'set -e; i=0; ((i++)); echo "到達"'
=> 1

最後の行は見落としやすい動きです。((i++)) は「加算前の値 0」が式の値になり、0 は偽なので終了ステータス 1 を返します。set -e のもとでは i=$((i+1)) と書くと止まりません。

関数を if や || の左で呼ぶと、関数の中でも止まらない

set -e
f() { false; echo "f の中で継続"; }

f || echo "f は非0扱い"
echo "到達"

f の中で継続
到達

f を || の左で呼んだため、関数の中の false でも止まらず、次の行まで進みました。しかも関数の最後の echo が成功したので、f 全体は 0 になり、|| の右も実行されていません。同じ関数を単独で f と呼んだ場合は、false の時点でスクリプトが終了しました（全体の値は 1）。

対策は、関数の中で必要な箇所に || return 1 を明示することです。

f() {
  step1 || return 1
  step2 || return 1
}

local と export は代入と宣言を分ける

# 直す前：$(...) の結果が local の成功で隠れる
local x=$(some_command)

# 直した後：宣言と代入を分ける
local x
x=$(some_command)

set -e の詳しい使い方や trap による後始末は別のテーマになるため、ここでは終了ステータスに関わる動きに絞りました。

関数の return と exit の違い

#!/bin/bash
check_file() {
  [ -f "$1" ] || return 3
  echo "found: $1"
}
die() {
  echo "die: $1" >&2
  exit 4
}

check_file /etc/hostname;  echo "check_file(あり) => $?"
check_file /nonexistent;   echo "check_file(なし) => $?"

noreturn() { false; }
noreturn; echo "return なしの関数 => $? (最後のコマンドの値)"

out=$(die "サブシェル内"); echo "\$(die) の後も続く => $?"
die "ここで終了"
echo "この行は実行されない"

found: /etc/hostname
check_file(あり) => 0
check_file(なし) => 3
return なしの関数 => 1 (最後のコマンドの値)
die: サブシェル内
$(die) の後も続く => 4
die: ここで終了

スクリプト全体の終了ステータスは 4 でした。ここから3つのことがわかります。

• return を書かない関数は、最後に実行したコマンドの値を返します。 関数の最後が echo だと、途中でエラーがあっても 0 になります。
• $(...) の中の exit は、その中（サブシェル）だけを終わらせます。 外側のスクリプトは続き、値は $? で受け取れます。( ... ) で囲んだ場合も同じで、(exit 3); echo $? は 3 を表示しました。
• 関数の中で exit を呼ぶと、関数ではなくスクリプト全体が終わります。

関数の外で return を使うとどうなるか

$ bash lib.sh        # 中身は「return 7」だけ
lib.sh: line 1: return: can only `return' from a function or sourced script
=> 2

$ bash -c 'source ./lib.sh; echo "source後 => $?"'
source後 => 7

source（または .）で読み込むファイルでは return が使えます。逆に、読み込まれる側のファイルに exit 7 と書くと、読み込んだ側のシェルごと終了します（source ./lib2.sh の次の行は実行されず、全体が 7 で終わりました）。ライブラリとして読み込むファイルでは return を使うのが安全です。

return で返せるのは数値だけ

return は終了ステータスを返す仕組みなので、0〜255 の整数しか返せません。文字列や大きな数を返したいときは、echo で出力して $(...) で受け取ります。

get_name() { echo "report_$(date +%Y%m%d).csv"; }
name=$(get_name)

よく使うコマンドが返す値の一覧

「0 以外＝異常」と決めつけないために、身近なコマンドが実際に返した値を並べます（すべて今回実行した結果です）。

command -v は「コマンドがあるかどうか」を終了ステータスで答えてくれるので、スクリプトの冒頭で必要な道具がそろっているかを確かめるのに向いています。

if command -v jq >/dev/null; then
  echo "jq あり"
else
  echo "jq なし"
fi

grep の「一致なし」を set -e のもとで扱う

set -eo pipefail のスクリプトで件数を数えようとすると、一致が 0 件のときに grep が 1 を返し、そこでスクリプトが終わります。

$ bash -c 'set -eo pipefail; x=$(grep zzz /etc/hostname | wc -l); echo "x=$x"'
=> 1

「0 件も正常」として続けたいときは、|| true で 1 を受け止めます。

set -eo pipefail
n=$(grep -c zzz /etc/hostname || true)
echo "n=$n"

n=0

ループで複数のファイルを処理し、最後にまとめて返す

1件でもうまくいかなかったら最終的に 1 を返したい、という場面では、途中で止めずに変数へ記録しておき、最後に exit へ渡します。

for f in /etc/hostname /nonexistent /etc/passwd; do
  if ! [ -f "$f" ]; then
    echo "skip $f"
    err=1
    continue
  fi
  echo "ok $f"
done
exit ${err:-0}

ok /etc/hostname
skip /nonexistent
ok /etc/passwd

全体の終了ステータスは 1 でした。${err:-0} は「err が未設定なら 0」という書き方です。

$(...) と代入の終了ステータス

コマンド置換 $(...) の値がどこに現れるかは、置かれた場所で変わります。

x=$(exit 4);      echo "代入 => $?"
echo "$(exit 5)"; echo "echo の引数内 => $?"

代入 => 4

echo の引数内 => 0

代入だけの文では $(...) の値が $? になり、他のコマンドの引数として使った場合は、そのコマンド（ここでは echo）の値になります。 コマンド置換の結果を確かめたいときは、いったん変数に代入してから使うと、値を取りこぼしません。

256以上や負の数を指定したとき

終了ステータスは8ビット（0〜255）で親プロセスに渡されます。範囲の外の値を指定すると、256 で割った余りになります。

$ exit 255
=> 255
$ exit 256
=> 0
$ exit 257
=> 1
$ exit 1000
=> 232
$ exit -1
=> 255

exit 256 は 0、つまり「成功」として伝わる点に気をつけます。件数やエラー数をそのまま exit に渡すと、ちょうど 256 件のときに成功扱いになります。件数は標準出力で返し、終了ステータスは「0 か、少数の決まった値」にすると混乱がありません。

関数の return も同じで、return 256 は 0、return 300 は 44 になりました。bash 以外でも同様で、sh -c 'exit 256'（dash）は 0、python3 -c 'import sys; sys.exit(300)' は 44 でした。

数値以外を渡した場合は、メッセージが出て 2 になります。

$ exit abc
bash: line 1: exit: abc: numeric argument required
=> 2

自分で決めるときの目安

bash のマニュアル（Exit Status の節）にも、終了ステータスは 0〜255 で、シェルが 125 より大きい値を特別に使うことがあると書かれています。独自の値は 3〜125 の範囲から選ぶと、126・127・128+n と区別できます。

コピペで使えるひな形：終了ステータスを使い分けるスクリプト

ここまでの内容を1つにまとめた例です。引数の誤りは 2、入力が見つからないときは 66、処理が完了しなかったときは 1 を返します。

#!/bin/bash
# backup.sh : 終了ステータスを使い分けるひな形
set -euo pipefail

readonly E_USAGE=2      # 使い方の誤り
readonly E_NOINPUT=66   # 入力が見つからない
readonly E_FAILED=1     # 処理がうまくいかなかった

usage() {
  echo "usage: $0 <コピー元ディレクトリ> <出力先ファイル.tar.gz>" >&2
  exit "$E_USAGE"
}

[ $# -eq 2 ] || usage
src=$1
dest=$2

if [ ! -d "$src" ]; then
  echo "error: $src が見つかりません" >&2
  exit "$E_NOINPUT"
fi

trap 'rc=$?; [ "$rc" -eq 0 ] || echo "終了ステータス $rc で止まりました" >&2' EXIT

if tar -czf "$dest" -C "$src" . ; then
  echo "ok: $dest を作成しました"
else
  rc=$?
  echo "error: tar が $rc を返しました" >&2
  exit "$E_FAILED"
fi

count=$(tar -tzf "$dest" | wc -l)
echo "entries: $count"

src/ に2つのファイルを置いて実行した結果です。

$ bash backup.sh; echo "=> $?"
usage: backup.sh <コピー元ディレクトリ> <出力先ファイル.tar.gz>
=> 2

$ bash backup.sh /nonexistent out.tar.gz; echo "=> $?"
error: /nonexistent が見つかりません
=> 66

$ bash backup.sh src out.tar.gz; echo "=> $?"
ok: out.tar.gz を作成しました
entries: 3
=> 0

$ bash backup.sh src /nonexistent/out.tar.gz; echo "=> $?"
tar (child): /nonexistent/out.tar.gz: Cannot open: No such file or directory
tar (child): Error is not recoverable: exiting now
tar: /nonexistent/out.tar.gz: Cannot write: Broken pipe
tar: Child returned status 2
tar: Error is not recoverable: exiting now
error: tar が 2 を返しました
終了ステータス 1 で止まりました
=> 1

呼び出す側は、値に応じて次の動きを決められます。

bash backup.sh src out.tar.gz && echo "次の処理へ" || echo "通知する"

ok: out.tar.gz を作成しました
entries: 3
次の処理へ

このひな形のポイントは次のとおりです。

• エラーメッセージは >&2 で標準エラーに出す。 標準出力は結果のデータ用に空けておきます。
• if コマンド; then ... else rc=$? の形で、値を else の先頭で受け取る。
• trap ... EXIT の中の $? は、終了しようとしている値。 終了時に共通の記録を残せます。なお、trap の中で exit 9 のように書くと、最終的な終了ステータスは 9 に置き換わりました。値を保ちたいときは trap の中で exit を書かないようにします。

つまずきやすい点のチェックリスト

よくある質問

Q. 終了ステータスと「戻り値」は同じものですか？ A. シェルスクリプトでは同じものを指して使われることが多い言葉です。コマンドや関数が返す 0〜255 の整数が終了ステータスで、$? で読み取れます。他の言語の「戻り値」のように文字列や配列は返せないため、データは標準出力で受け渡します。

Q. if [ $? -eq 0 ] と if コマンド はどちらがよいですか？ A. 成功したかどうかだけを見るなら if コマンド; then が短く、$? の上書きも起きません。値そのものをログに出したい、複数の値で分岐したいときは、直後に rc=$? で保存してから case "$rc" in で分けると読みやすくなります。

Q. 終了ステータス 1 と 2 はどう使い分けますか？ A. 決まった規則はありませんが、bash の組み込みコマンドは使い方の誤り（引数不足や不正なオプション）に 2 を返します。自作スクリプトでも「引数の誤りは 2、それ以外のエラーは 1」とそろえると、呼び出す側が原因を切り分けやすくなります。

Q. バックグラウンドで動かしたコマンドの終了ステータスはどう取りますか？ A. wait プロセスID の終了ステータスが、そのコマンドの値になります。(exit 42) & wait $!; echo $? は 42 を表示しました。$! は直前にバックグラウンドで起動したプロセスの ID です。

まとめ

• 終了ステータスは 0〜255 の整数で、0 が成功。 意味はコマンドごとに決まっており、grep や diff の 1 は「一致なし」「差分あり」を表します。
• 126 は実行できない、127 は見つからない、128+n はシグナル n で終了。 130 は Ctrl+C、137 は強制終了、143 は停止要求です。
• $? は次のコマンドで上書きされるので、直後に rc=$? で保存するか、if コマンド; then と直接書きます。
• && と || は左から順に評価される。 A && B || C は B が 0 以外でも C が動きます。
• パイプの $? は右端の値。 途中の値は ${PIPESTATUS[@]}、全体として知りたいなら set -o pipefail を使います。
• set -e は if・&&・||・! の中と local x=$(...) では止まりません。
• return は関数だけ、exit はスクリプト全体を終える。 256 以上は 256 で割った余りになり、exit 256 は 0 になります。

参考・出典

• GNU Bash Reference Manual「Exit Status」（今回開いて、0〜255 の範囲、126・127・128+N、組み込みコマンドの 2 の記述を確認）

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。