ファイル名に空白や改行があっても壊れないシェルスクリプト設計｜NUL区切り・read -d・配列で安全にループする方法

この記事のポイント

・forループ＋コマンド置換はスペースでフィールド分割され壊れる
・find -print0 | xargs -0 でNUL区切りに統一するのが基本設計
・IFS= read -r -d '' でNULストリームを安全にループできる
・先頭ハイフンのファイル名は -- でオプション解釈を止めてから渡す

# 問題が起きる例：コマンド置換でのフィールド分割
$ touch "my file.log"      # スペース入りのファイルを作成

$ for f in $(find . -name "*.log"); do
>     echo "$f"
> done

# 出力例（環境により異なります）
./my
file.log
# "my file.log" が2つの引数に分割されてしまう

# 壊れる例（1）：for + コマンド置換
for f in $(find /backup -name "*.tar.gz"); do
    echo "処理: $f"      # ファイル名のスペースで引数が分割される
done

# 壊れる例（2）：ls の出力をパイプで渡す
ls /backup | xargs gzip
# ls はスペース区切りで出力、xargs のデフォルト区切りもスペース

# 壊れる例（3）：cat でファイルリストを読む
for f in $(cat file_list.txt); do
    cp "$f" /dest/       # file_list.txt に空白入り行があると壊れる
done

# 安全な例（1）：find -print0 と xargs -0 の組み合わせ
find /backup -name "*.tar.gz" -print0 | xargs -0 -I{} gzip -d {}

# 安全な例（2）：-exec を使う場合（xargs 不要・1ファイルずつ処理）
find /backup -name "*.tar.gz" -exec gzip -d {} \;

# 安全な例（3）：-exec {} + で複数ファイルをまとめて渡すバッチ処理
find /backup -name "*.tar.gz" -exec gzip -d {} +

# 出力例（環境により異なります）
# /backup/file with space.tar.gz なども正しく処理される

# 安全な例：IFS= read -r -d '' でNULストリームをループ
while IFS= read -r -d '' f; do
    echo "処理中: $f"
    cp -- "$f" /dest/
done < <(find /backup -name "*.tar.gz" -print0)

# 出力例（環境により異なります）
# 処理中: /backup/my file.log
# 処理中: /backup/report 2024-01.tar.gz

# 安全な例：mapfile -d '' でNUL区切りの結果を配列に格納
mapfile -d '' -t files < <(find /backup -name "*.tar.gz" -print0)

# 配列の要素数を確認
echo "対象ファイル数: ${#files[@]}"
# 対象ファイル数: 3（出力例。環境により異なります）

# ループで処理
for f in "${files[@]}"; do
    echo "処理: $f"
done

# 危険な例：先頭ハイフンがオプションとして解釈される
f="-rf"
rm "$f"          # rm -rf として実行される（意図しない削除の危険）

# 安全な例：-- でオプション解釈を停止する
rm -- "$f"       # -- 以降はすべてファイル名として解釈される
cp -- "$f" /dest/
grep -- "$pattern" "$f"

# 問題になる例：クォートなしの変数展開でグロブが起きる
f="report[2024].log"
echo $f           # カレントディレクトリに report2024.log があると展開される

# 安全な例：ダブルクォートで囲めばグロブ展開されない
echo "$f"         # "report[2024].log" がそのまま表示される（出力例）

# リテラルとして書く場合はシングルクォートが確実
ls 'report[2024].log'   # グロブ展開なし

# bash バージョン確認
bash --version
# GNU bash, version 4.2.46 → -d '' は使えない

# 対処：while IFS= read -r -d '' でループする方式に切り替える
while IFS= read -r -d '' f; do
    process "$f"
done < <(find . -name "*.log" -print0)

# 問題のある例：パイプ後はサブシェルになる
count=0
find . -name "*.log" -print0 | while IFS= read -r -d '' f; do
    count=$((count + 1))
done
echo "count=$count"    # 0 が表示される（サブシェルの変数は外に出ない）

# 対処：プロセス置換で現在のシェルでループを実行
count=0
while IFS= read -r -d '' f; do
    count=$((count + 1))
done < <(find . -name "*.log" -print0)
echo "count=$count"    # 正しいカウントが表示される（出力例。環境により異なります）

# -n 1 で1ファイルずつ処理（確実だが遅い）
find . -name "*.log" -print0 | xargs -0 -n 1 gzip

# -n 100 で100ファイルずつバッチ処理
find . -name "*.log" -print0 | xargs -0 -n 100 gzip