コマンドライン
PR

シェルスクリプト入門|bashの変数・if・for・終了ステータスを実例で解説

シェルスクリプト入門|bashの変数・if・for・終了ステータスを実例で解説
hr
記事内に商品プロモーションを含む場合があります

毎日同じコマンドを何度も打っている、手順書を見ながらサーバーでバックアップを取っている――そんな作業はシェルスクリプトにまとめると、1 つのコマンドで実行できるようになります。この記事では、bash(バッシュ)のシェルスクリプトを初めて書く人向けに、変数・if・for・関数・終了ステータスの基本と、失敗に早く気づくための set -euo pipefail を、実行結果つきで解説します。最後に、ログを日付付きでバックアップするスクリプトを作ります。

実行結果は、Windows 11 の Git Bash(GNU bash 5.2.37)で確かめたものです。bash の動きの説明は、bash の公式マニュアル(GNU の bash リポジトリの man ページ。man7.org 掲載版)で確認しています。

シェルスクリプトとは

シェルは、ターミナルで打ったコマンドを実行するプログラムで、Linux でよく使われるのが bash です。シェルスクリプトは、ふだんターミナルで打つコマンドを、順番にテキストファイルへ書いておいたものです。ファイルの拡張子は .sh にするのが一般的です。

最初のスクリプトを作って動かす

テキストエディターで次の内容を書き、hello.sh という名前で保存します。改行コードは LF にしてください(理由は後の「よくある間違い」で説明します)。

#!/bin/bash
echo "Hello, shell script!"
echo "今日は $(date +%Y-%m-%d) です"

1 行目の #!/bin/bash(シバン)

1 行目の #!/bin/bash はシバン(shebang)と呼ばれ、「このファイルは /bin/bash で実行する」という指定です。bash のマニュアルにも「#! で始まるファイルは、1 行目の残りの部分が、プログラムを実行するインタープリター(解釈して実行するプログラム)を指定する」と書かれています。必ずファイルの先頭の 1 行目に、空白を入れずに書きます。2 行目以降の # から行末まではコメント(実行されないメモ)になります。

方法 1:bash script.sh で実行する

いちばん確実なのは、bash コマンドにファイル名を渡す方法です。この方法では実行権限がなくても動きます。

bash hello.sh
Hello, shell script!
今日は 2026-10-19 です

方法 2:chmod +x を付けて ./script.sh で実行する

Linux では、ファイルに実行権限を付けると、コマンドのように直接実行できます。このときシバンに書いたプログラム(/bin/bash)が使われます。

chmod +x hello.sh
./hello.sh

先頭の ./(今いるディレクトリの)は省略できません。hello.sh とだけ打つと、hello.sh: command not found(終了ステータス 127)になりました。シェルは環境変数 PATH に登録されたディレクトリからしかコマンドを探さず、今いるディレクトリは普通そこに入っていないためです。PATH の仕組みは「環境変数PATHとは?」で解説しています。Linux では、実行権限のないファイルを ./ で実行しようとすると、権限がないというエラーになります。

Windows の Git Bash では、実行権限は効きません。この PC で確かめたところ、#! で始まるファイルは作った時点で ls -l の表示が -rwxr-xr-x になり、chmod -x や chmod 644 をしても変わりませんでした。逆に、#! のない -rw-r--r-- のファイルも ./ で実行できました。権限の動きは Linux のサーバーで確かめてください。755・644 などの数字と記号の対応は「chmod 計算ツール」で確かめられます。

変数の使い方

変数は「名前=値」で作り、使うときは名前の前に $ を付けます。

#!/bin/bash
name="taro"
echo "こんにちは、$name さん"
echo "こんにちは、${name}さん"
echo 'こんにちは、$name さん'
こんにちは、taro さん
こんにちは、taroさん
こんにちは、$name さん

ダブルクォート(”)の中では変数が値に置き換わり、シングルクォート(’)の中では $name がそのまま文字として出ます。変数名のすぐ後に文字が続くときは ${name} と波かっこで囲みます。たとえば "$name_dir" は「name_dir という変数」と読まれて空になり、"${name}_dir" と書くと taro_dir になりました。

= の前後に空白を入れない

ほかのプログラミング言語の感覚で name = "taro" と書くと、次のエラーになります。

var.sh: line 2: name: command not found

空白があると、bash は「name というコマンドに、= と taro という 2 つの引数を渡す」と解釈するからです。name= "taro"(= の後だけ空白)でも taro: command not found になりました。こちらは「name を空にして taro コマンドを実行する」という意味になってしまいます。= の前後には空白を入れない、と覚えてください。

変数は “$var” と引用符で囲む

シェルスクリプトでいちばん大事な習慣が、変数を使うときはダブルクォートで囲むことです。引用符がないと、値が空白の位置で分けられ(単語分割)、* などはファイル名に置き換わります。名前に空白を含むファイル「my report.txt」で確かめます。

#!/bin/bash
file="my report.txt"
cat $file
echo "---"
cat "$file"
cat: my: No such file or directory
cat: report.txt: No such file or directory
---
日報

引用符なしの cat $file は、「my」と「report.txt」という 2 つのファイルを開こうとして失敗しました。cat ならエラーで済みますが、rm だと深刻です。練習用のディレクトリに「my」「report.txt」「my report.txt」の 3 つのファイルを作り、file="my report.txt" のあとに rm $file を実行したところ、消したかった my report.txt は残り、関係のない my と report.txt が消えました。エラーも出ません。

コマンドの結果を変数に入れる $( )

$(コマンド) と書くと、コマンドの出力をその場所に埋め込めます(コマンド置換)。変数に入れておけば、何度でも使えます。古い書き方のバッククォート(`コマンド`)は、マニュアルで非推奨とされています。

#!/bin/bash
today=$(date +%Y%m%d)
count=$(ls *.log | wc -l)
echo "日付: $today"
echo "ログの数: $count"
echo "バックアップ名: app-$today.log"
日付: 20261019
ログの数: 2
バックアップ名: app-20261019.log

引数を受け取る($1・$#・$@)

スクリプトの後ろに書いた値(引数)は、$1・$2 …(1 つ目・2 つ目の引数)、$#(引数の数)、”$@”(すべての引数)で受け取れます。$0 はスクリプトの名前です。

#!/bin/bash
echo "スクリプト名: $0"
echo "1つ目の引数: $1"
echo "2つ目の引数: $2"
echo "引数の数: $#"
echo '--- "$@" で回す ---'
for a in "$@"; do
  echo "[$a]"
done
echo '--- $@ で回す(引用符なし)---'
for a in $@; do
  echo "[$a]"
done
bash args.sh "my report.txt" memo.txt
スクリプト名: args.sh
1つ目の引数: my report.txt
2つ目の引数: memo.txt
引数の数: 2
--- "$@" で回す ---
[my report.txt]
[memo.txt]
--- $@ で回す(引用符なし)---
[my]
[report.txt]
[memo.txt]

マニュアルにも「”$@” は “$1” “$2” … と同じ」と書かれているとおり、引用符で囲んだ "$@" は空白入りの引数を 1 つのまま渡します。引用符のない $@ は、my と report.txt に分かれてしまいました。引数をまとめて扱うときは "$@" を使います。

条件分岐 if と test・[ ]・[[ ]]

if は「後ろに書いたコマンドが成功したら then の中を実行する」という仕組みです。条件を調べるコマンドとしてよく使うのが [ ] です。[ は test コマンドの別名で、[ -f "$file" ] は test -f "$file" と同じ意味です。

#!/bin/bash
file="$1"
if [ -f "$file" ]; then
  echo "$file はあります"
elif [ -d "$file" ]; then
  echo "$file はディレクトリです"
else
  echo "$file は見つかりません"
fi

app.log(ファイル)、logs(ディレクトリ)、none.log(存在しない)を渡すと、それぞれ「app.log はあります」「logs はディレクトリです」「none.log は見つかりません」と表示されました。[ の後と ] の前には必ず空白を入れ、if の終わりは fi(if を逆から書いたもの)です。

よく使う条件の書き方

書き方真(成功)になる条件
[ -f “$f” ]ふつうのファイルとして存在する
[ -d “$d” ]ディレクトリとして存在する
[ -e “$f” ]種類を問わず存在する
[ ! -f “$f” ]ファイルが存在しない(! は否定)
[ -z “$s” ] / [ -n “$s” ]文字列が空 / 空でない
[ “$a” = “$b” ] / [ “$a” != “$b” ]文字列として等しい / 等しくない
[ “$n” -eq 10 ]数値として等しい(-ne は等しくない)
[ “$n” -gt 5 ] / -ge / -lt / -leより大きい / 以上 / より小さい / 以下

文字列の比較(=)と数値の比較(-eq)は別物です。[ 010 -eq 10 ] は真(数値として 10 と 10)、[ "010" = "10" ] は偽(文字列として違う)になりました。-eq に数字以外を渡すと [: abc: integer expression expected というエラーが出ます。

[ ] と [[ ]] の違い

bash には [[ ]] という書き方もあります。マニュアルによると、[[ ]] の中では単語分割とファイル名の展開が行われません。そのため変数が空でもエラーになりにくく、パターンや正規表現での比較もできます。

f="backup-20261019.tar.gz"
if [[ $f == *.tar.gz ]]; then echo "tar.gz です"; fi
if [[ $f =~ ^backup-([0-9]{8}) ]]; then echo "日付: ${BASH_REMATCH[1]}"; fi

「tar.gz です」「日付: 20261019」と表示されました。[[ ]] は bash の機能で、sh など他のシェルでは使えないことがあります(sh がどのシェルを指すかは環境によって違います)。ただし、[[ ]] の中でも < > は文字列の辞書順の比較で、[[ 10 > 9 ]] は偽になりました。数値は -gt などか、(( 10 > 9 )) を使います。

繰り返し:for と while read

for でファイルを 1 つずつ処理する

for は、in の後ろに並べた値を 1 つずつ変数に入れて繰り返します。*.log と書くと、その場所の .log ファイルの名前に置き換わります。

#!/bin/bash
for f in *.log; do
  lines=$(wc -l < "$f")
  echo "$f: $lines 行"
done
app.log: 2 行
error 1.log: 1 行

空白入りの名前も 1 つとして扱えています。注意点は 2 つです。

  • for f in $(ls *.log) と書かない:ls の出力が空白で分けられ、[app.log] [error] [1.log] の 3 つになりました。
  • 1 つも一致しないと「*.log」という文字がそのまま入る:.log のないディレクトリで実行すると、*.log: No such file or directory のエラーが出ました。マニュアルのとおり、一致がないときはパターンがそのまま残るためです。ループの最初に [ -f "$f" ] || continue(ファイルでなければ次へ)を書くか、shopt -s nullglob を設定すると防げます。

下の階層のファイルまで探して処理したいときは、find を使います(「findコマンドの使い方」参照)。

while read でファイルを 1 行ずつ読む

ファイルの中身を 1 行ずつ処理するときは while read を使います。servers.txt に「サーバー名 IP アドレス」が並んでいる例です(3 行目は空行)。

web01 192.168.0.11
web02 192.168.0.12

db01  192.168.0.21
#!/bin/bash
while read -r name ip; do
  [ -z "$name" ] && continue
  echo "$name の IP は $ip"
done < servers.txt
web01 の IP は 192.168.0.11
web02 の IP は 192.168.0.12
db01 の IP は 192.168.0.21

read の後に変数を 2 つ書くと、空白で区切った 1 つ目が name、残りが ip に入ります。最後の < servers.txt で、ファイルを while の入力にしています。read には -r を付けるのが基本です。-r がないと \ が特別な記号として扱われ、C:\temp\new という行が C:tempnew になりました。

関数をつくる

何度も使う処理は関数にまとめます。関数の中では、渡された値を $1・$2 で受け取ります(スクリプトの引数とは別物です)。

#!/bin/bash
greet() {
  local name="$1"
  echo "こんにちは、${name}さん"
}

is_number() {
  [[ "$1" =~ ^[0-9]+$ ]]
}

greet "佐藤"
if is_number "42"; then echo "42 は数字"; fi
if ! is_number "4a"; then echo "4a は数字ではない"; fi
msg=$(greet "田中")
echo "受け取った値: $msg"
こんにちは、佐藤さん
42 は数字
4a は数字ではない
受け取った値: こんにちは、田中さん

ポイントは 3 つです。

  • 関数は使う前に定義する:スクリプトは上から順に実行されるので、呼び出しより上に書きます。
  • 関数の中の変数は local を付ける:付けないと、関数の外の同じ名前の変数を書き換えます。外で count=1 のとき、関数の中で count=100 とすると外も 100 になり、local count=200 なら 1 のままでした。
  • 値を返すときは echo して $( ) で受け取る:return で返せるのは 0〜255 の終了ステータスだけです。is_number のように、最後のコマンドの成功・失敗がそのまま関数の結果になり、if で使えます。

終了ステータス $? と exit

コマンドは終わるときに終了ステータスという 0〜255 の数字を返します。0 が成功、0 以外が失敗です。直前のコマンドの終了ステータスは $? で見られます。この PC で確かめた値は次のとおりです。

実行したもの$? の値
ls app.log(ファイルあり)0
ls app.log(ファイルなし)2
grep -q ERROR app.log(見つからない)1
grep -q ERROR nofile(ファイルがない)2
存在しないコマンド127

マニュアルでは、コマンドが見つからないときは 127、見つかったが実行できないときは 126、シグナル N で終了したときは 128+N と決められています。1 や 2 の意味はコマンドごとに違うので、man ページや –help で確かめます。

スクリプト自身の終了ステータスは exit 数字 で決めます。使い方が間違っているときにメッセージを出して終わる、よくある形です。

#!/bin/bash
if [ $# -ne 1 ]; then
  echo "使い方: $0 ファイル名" >&2
  exit 2
fi
echo "$1 を処理します"
exit 0

引数なしで実行すると「使い方: ex.sh ファイル名」と表示され、$? は 2 でした。>&2 は、メッセージを標準エラー出力(エラー用の出力先)に出す書き方です。exit の値は 0〜255 の範囲にします(exit 300 は 44 になりました)。

set -euo pipefail で失敗に気づく

bash は、途中のコマンドが失敗しても何事もなかったように次の行へ進みます。たとえば次のスクリプトは、cd に失敗したのに 3 行目を実行し、終了ステータスも 0 でした。

#!/bin/bash
cd ./no-such-dir
echo "ここで rm を実行すると、今いる場所のファイルが消える"
noe.sh: line 2: cd: ./no-such-dir: No such file or directory
ここで rm を実行すると、今いる場所のファイルが消える

3 行目が rm -rf ./* のような削除だったら、cd に失敗したせいで別の場所のファイルを消してしまいます。こうした事故を防ぐため、スクリプトの 2 行目に次の 1 行を書くのが定番です。

set -euo pipefail

set コマンドの 3 つのオプションをまとめた指定です。先ほどのスクリプトに set -e を入れると、cd のエラーで止まり、終了ステータスは 1 になりました。

オプション意味(マニュアルの要約)
-eコマンドが失敗(0 以外)したら、すぐに終了する
-u設定されていない変数を使おうとしたらエラーにし、スクリプトを終了する
-o pipefailパイプ(|)全体の終了ステータスを、最後に失敗したコマンドの値にする(全部成功なら 0)

-u:変数名の打ち間違いに気づける

変数名を打ち間違えると、bash は空の値として扱います。backup_dir="./backup" と書いたのに "$backup_dri/old" と打ち間違えると、-u がなければ「/old」になってしまいました。ルートディレクトリ直下を指す、危ないパスです。-u を付けると次のエラーで止まります。

u.sh: line 4: backup_dri: unbound variable

-u のときは、引数を省略されただけでも $1: unbound variable で止まります。省略できる引数は name="${1:-guest}" のように、${変数:-省略時の値} で決めておきます。引数なしなら guest になります。

-o pipefail:パイプの途中の失敗を見逃さない

パイプの終了ステータスは、ふつうは最後のコマンドの値です。存在しないファイルを grep して wc -l に渡すと、grep は失敗しているのに wc が成功するため、全体は 0(成功)でした。

set -o pipefail のあとで同じことをすると、終了ステータスは grep の 2 になりました。-e と組み合わせると、ここで止まります。

set -e の注意点

set -e は思わぬところで止まったり、止まらなかったりします。

  • 「見つからない」も失敗として止まる:count=$(grep -c ERROR app.log) は、ERROR が 0 件だと grep の終了ステータスが 1 になり、何も表示せずにスクリプトが終わりました。0 件もありえるなら count=$(grep -c ERROR app.log || true) と書くと、「ERROR の数: 0」と表示されて先へ進みました。
  • if の条件や &&・|| の途中では止まらない:マニュアルには、if・elif・while の条件、&& や || の最後以外のコマンド、! を付けたコマンドが失敗してもシェルは終了しない、と書かれています。成功・失敗で処理を分けたいときは if grep -q ERROR app.log; then のように if に入れれば安全です。
  • ((i++)) で止まることがある:i が 0 のときの ((i++)) は、計算結果が 0 なので終了ステータスが 1 になり、set -e のスクリプトはそこで終わりました。数を増やすときは i=$((i + 1)) と書くのが無難です。

実例:ログファイルを日付付きでバックアップする

logs ディレクトリの .log ファイルを、backup ディレクトリに「名前_日付.log」でコピーするスクリプトです。

#!/bin/bash
# ログファイルを日付付きの名前でバックアップする
set -euo pipefail

src_dir="${1:-./logs}"
backup_dir="${2:-./backup}"
today=$(date +%Y%m%d)

log() {
  echo "[$(date '+%H:%M:%S')] $1"
}

if [ ! -d "$src_dir" ]; then
  echo "エラー: $src_dir というディレクトリがありません" >&2
  exit 1
fi

mkdir -p "$backup_dir"

count=0
for f in "$src_dir"/*.log; do
  [ -f "$f" ] || continue
  name=$(basename "$f" .log)
  dest="$backup_dir/${name}_${today}.log"
  cp -p "$f" "$dest"
  log "コピーしました: $f -> $dest"
  count=$((count + 1))
done

log "完了: ${count} 個のファイルをバックアップしました"

backup_logs.sh という名前で保存し、logs ディレクトリ(app.log、access log.log、readme.txt が入っている)と同じ場所で実行しました。

./backup_logs.sh
[00:19:19] コピーしました: ./logs/access log.log -> ./backup/access log_20261019.log
[00:19:19] コピーしました: ./logs/app.log -> ./backup/app_20261019.log
[00:19:19] 完了: 2 個のファイルをバックアップしました

readme.txt は対象外で、空白入りの名前もコピーできました。存在しないディレクトリを渡すとエラーを表示して終了ステータス 1、.log が 1 つもないときは「完了: 0 個」で終了ステータス 0 でした。

中の工夫をまとめます。${1:-./logs} で引数を省略したときの場所を決め、mkdir -p でバックアップ先がなければ作り、basename "$f" .log でパスと拡張子を取り除いた名前を取り出しています。cp -p は更新日時なども元のファイルのまま残すオプションです。同じ日に 2 回実行すると上書きされます。

Linux のサーバーで毎日自動で動かすなら、cron に登録します。たとえば「毎日 3:00」は 0 3 * * * です。cron 式の書き方や次に実行される日時は「Cron式生成・解説ツール」で確かめられます。cron から動かすときは、引数で絶対パスを渡しましょう(今いるディレクトリが手で実行したときと違うことが多いため)。

よくある間違いとエラー

書いたもの・症状出たエラー・結果直し方
name = “taro”name: command not found= の前後の空白を消す
if [ $mode = prod ](mode が空)[: =: unary operator expected“$mode” と引用符で囲む
if [“$mode” = “prod”][prod: command not found[ と ] の内側に空白を入れる
if [ “$mode”=”prod” ]エラーなしで、mode が dev でも常に真= の前後に空白を入れる
if [ “$size” > 100 ]エラーなしで常に真になり、「100」という空のファイルができた[ “$size” -gt 100 ] と書く

特に危ないのは、エラーが出ないのに間違っている 2 つです。[ "$mode"="prod" ] は空白がないため「dev=prod」という 1 つの文字列を調べることになり、「空でないので真」と判定されます。[ "$size" > 100 ] の > は比較ではなくリダイレクト(出力を 100 というファイルに書く)として解釈され、size が 5 でも「100 より大きい」と表示されました。

Windows で作ったスクリプトが Linux で動かない(改行コード)

Windows のエディターで保存したスクリプトは、改行コードが CRLF になっていることがあります。Linux の bash は行末の CR をコマンドの一部として読むため、エラーになります。やっかいなのは、Git Bash では CRLF のスクリプトもそのまま動いてしまうことです。サーバーに置く前に file スクリプト名 を実行し、「with CRLF line terminators」と出たら LF に変換します。確認と変換の方法は「改行コードCRLFとLFの違いと確認・変換方法」で詳しく解説しています。

よくある質問

書いたスクリプトの間違いを見つける方法はありますか?

ShellCheck という無料のツールがあります。公式サイト(shellcheck.net)によると、シェルスクリプトのバグを見つけるためのツールで、GPLv3 のフリーソフトウェアです。apt・dnf・brew などでインストールでき、引用符の付け忘れのような、この記事で紹介した間違いを指摘してくれます(この PC には未導入のため、結果は載せていません)。公式サイトに貼り付けて調べる画面もありますが、社内の情報を含むスクリプトは外部のサイトに貼らず、手元で使いましょう。

bash -n script.sh なら、実行せずに文法の誤り(fi の書き忘れなど)を確かめられます。bash -x script.sh は実行したコマンドを 1 行ずつ表示するので、原因探しに便利です。

まとめ

シェルスクリプトは、1 行目に #!/bin/bash、2 行目に set -euo pipefail を書き、変数は "$var" と引用符で囲む――この 3 つを守るだけで、多くの事故を防げます。まずは毎日打つコマンドをまとめるところから始めましょう。

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました