結線例
八本の線と、切れやすい箇所
結線は、目的から逆に引きます。先にコマンドを並べるのではなく、何を確かめたいかを決め、 そのために必要な端子を左から順に繋ぐ。この順序を守るだけで、途中で詰まったときに どこまで動いているのかが分かります。
八本とも、実際の作業で何度も書き直した形です。分解の欄には、一字ずつ打つ順序を書きました。 切れる箇所の欄には、エラーを出さずに結果だけを変える落とし穴を書いてあります。
日本語名を含む一覧を、壊さずに数える
find . -type f -print0 | xargs -0 -n1 basename | sort | uniq -d
名前の区切りを改行から NUL に変えると、空白を含むディレクトリ名でも途中で切れません。最後の uniq -d は、別々の場所にある同名ファイルを拾います。
分解
- find で対象を絞る。-type f を付けないとディレクトリも混ざる。
- -print0 で NUL 区切りにする。ここを -print にすると、この先が全部崩れる。
- xargs -0 で受け、-n1 で一件ずつ basename に渡す。
- sort してから uniq -d で重複だけを残す。
切れる箇所
xargs 側の -0 を落とすと、空白で名前が分割され、basename が別のファイルを指します。エラーは出ません。
直近のエラーを、時刻ごとに数える
grep -h 'ERROR' /var/log/app.log | cut -c1-13 | sort | uniq -c | sort -nr | head -5
ISO 8601 の日時なら、先頭十三文字で「2026-11-13T09」までが残ります。時刻ごとにまとめて数え、多い順に五件だけ出します。ログの書式が変わったら cut の数字だけを直します。
分解
- grep -h でファイル名の前置を消す。ここが崩れると cut の位置がずれる。
- cut -c1-13 で日時の部分だけを残す。バイト指定の -b は日本語で壊れるので使わない。
- sort して同じ時刻を隣り合わせ、uniq -c で数える。
- sort -nr で多い順にし、head -5 で上位だけ見る。
切れる箇所
複数ファイルを一度に渡すときは -h が必須です。付いていないと cut がファイル名の文字を切ります。
文字コードを見分けてから変換する
file -I sheet.csv && iconv -f SHIFT_JIS -t UTF-8 sheet.csv > sheet-utf8.csv
まず現物の文字コードを確かめ、そのうえで変換します。当て推量で変換すると、二重変換で読めない文字列ができます。
分解
- file -I で charset を見る。empty や unknown が返るなら中身が壊れている。
- 先頭三バイトを od で見て、BOM の有無を確かめる。
- iconv で変換し、別名で保存する。元のファイルは残す。
- 変換後に wc -m で文字数が極端に減っていないか見る。
切れる箇所
iconv は変換できない文字に当たるとそこで止まります。//TRANSLIT を付けると別の文字に置き換わり、静かに意味が変わります。
改行コードを揃える
find . -name '*.sh' -print0 | xargs -0 sed -i '' $'s/\r$//'
Windows から来たスクリプトは、行末の CR のせいで bad interpreter になります。対象を絞ってから、その場で落とします。
分解
- find で拡張子を絞る。全ファイルに当てない。
- file で CRLF を確かめておく。混在していることもある。
- BSD の sed は -i のあとに空文字を渡す。GNU なら -i だけでよい。
- 実行してから bash -n で構文だけを再確認する。
切れる箇所
GNU の sed に -i '' を渡すと、空の拡張子を処理しようとして失敗します。環境を確かめてから打ってください。
リモートへ、差分だけを送る
rsync -avn --delete ./dist/ user@host:/srv/app/
送り元の末尾スラッシュは「中身を送る」の意味です。付け忘れると dist というディレクトリごと送られ、宛先が一段深くなります。まず -n で消える側を確認します。
分解
- 送り元の末尾にスラッシュを付ける。ここが最初の関門。
- -a で属性を保ち、-v で送った内容を出す。
- -n を付けて一度走らせ、削除予定の行だけを読む。
- 問題がなければ -n を外して同じ命令を打つ。
切れる箇所
--delete は宛先にしかないファイルを消します。バックアップを別に取っていない状態で、確認なしに打たないでください。
API の応答から、件数と失敗を読む
curl -sS --fail-with-body https://httpbin.org/json | jq -r '.slideshow.slides | length'
curl は 4xx と 5xx でも終了コード 0 を返します。-s だけだと本文だけが流れて、失敗に気づけません。--fail-with-body を付けると、本文を残したまま異常終了します。
分解
- -sS で進捗を消し、エラーの理由だけは出す。
- --fail-with-body で 4xx と 5xx を異常終了にする。
- jq -r で引用符を外し、length で件数を取る。
- echo $? で終了コードを確かめてから次へ進む。
切れる箇所
パイプの途中で失敗しても、パイプ全体の終了コードは最後の jq のものになります。set -o pipefail を先に置いてください。
作業ディレクトリを、固めて確かめる
tar -czf ../backup-$(date +%Y%m%d).tgz --exclude='node_modules' --exclude='.next' .
除外は対象より前に書きます。後ろに置くと、環境によっては黙って無視されます。固めたあとは、展開せずに中身を数えます。
分解
- --exclude を対象の . より前に並べる。
- ファイル名に日付を入れて、上書きを避ける。
- tar -tzf で一覧を出し、先頭と末尾だけ目で見る。
- tar -tzf backup.tgz | wc -l で件数を控える。
切れる箇所
macOS の bsdtar は --exclude の解釈が GNU と微妙に違います。除外したい名前は、まず -tzf の一覧に出ていないかで確かめるのが確実です。
容量を食っている場所を見つける
du -xhd1 /var | sort -h | tail -5
-x で別のファイルシステムに降りず、-d1 で一階層だけ見ます。sort -h は単位付きの数値をそのまま並べられるので、K と G が混ざっても順序が壊れません。
分解
- du -xhd1 で一階層の合計を出す。
- sort -h で小さい順にし、tail で大きいものだけ見る。
- 見当を付けたら、その下で同じ命令を打つ。
- 消す前に find で対象を列挙し、件数と合計を確かめる。
切れる箇所
du は権限の無いディレクトリを黙って飛ばします。合計が df と合わないときは、sudo を付けて一度取り直してください。

線を引く順序
長い結線を一度に書くと、動かないときに原因を切り分けられません。まず一段だけ打って、 出力を目で見る。次に二段目を足して、また見る。この往復を省いた結線は、たいてい どこかで静かに壊れています。パイプの途中を見たいときは tee を挟みます。
もう一つ、読む順序の話。端末の結線は左から右へ流れますが、直すときは右から読みます。 最後の出力が欲しい形になっていないなら、その手前の段が何を渡しているかを見る。 逆引の表は、その行き来のためにあります。逆引表へ