端末コマンド配線表
命令は、端子番号で引く。
端末のコマンドは、単語ではなく接続です。オプションは端子の定格を変え、パイプは 信号を別の端子へ送ります。だからこの表は、コマンドを五十音で並べた辞書ではなく、 番号の振られた端子と、その間を渡る線として組んであります。
扱うのは、日々の作業で実際に打つ範囲です。ファイルを探す、行を抜く、列を切る、 固める、送る、叩く。どの端子も macOS と Linux の実機で打ち、挙動の違う箇所は 両方を書きました。日本語のファイル名、全角の空白、BOM、CRLF のように、英語の 解説では飛ばされがちな落とし穴も、注意札として表の側に貼ってあります。
読み方は三つだけです。左の番号で端子を選ぶ。定格の欄で、効くオプションを確かめる。 結線の欄で、どの順に繋ぐかを見る。暗記は要りません。表を引き直せば済むように 書いてあります。
- 端子
- 24
- 結線
- 08
- 検証
- macOS 15 / Ubuntu 24.04
- 改訂
- 訂正は番号を保ったまま
端子一覧(抜粋)
二十四端子の全体を見る定格の欄には、その端子で最初に覚える一つだけを書きました。全部のオプションを並べると 表が読めなくなるためです。備考には、間違えやすい順序と、環境で変わる振る舞いを残しています。
| 番 | 端子 | 用途 | 定格 | 備考 |
|---|---|---|---|---|
| 01 | ls | 一覧を出す | -1 --color=never | パイプに渡すときは色を切る。長い形式の列は環境で揺れるので、機械的に読むなら find か stat を使う。 |
| 04 | find | 条件で探す | -type f -newermt | GNU は -printf が使える。macOS の find には無いので、名前だけ欲しいときは -exec basename で代用する。 |
| 05 | grep | 行を抜く | -rn --include | 日本語を扱うときは LC_ALL=C を付けると速いが、文字の境界が壊れる。件数だけ見るなら -c で足りる。 |
| 06 | sed | 置換する | -i.bak -E | macOS は -i のあとに拡張子が要る。空文字を渡すと控えが残らないので、作業前に -i.bak で一度走らせる。 |
| 07 | awk | 列を切る | -F, '{print $3}' | 区切りが全角の読点やタブのときは、-F ではなく FS を明示したほうが読み違えが少ない。 |
| 09 | sort | 並べ替える | -t, -k3,3n | 並び順はロケールに従う。数字の列を数値として並べるときは -n、単位付きなら -h。 |
| 12 | xargs | 引数に展開する | -0 -n1 | 空白を含む名前に -0 は必須。find 側の -print0 と必ず対で使う。-P を付けると順序は保証されない。 |
| 15 | tar | 固める、開ける | -czf / -tzf | macOS は bsdtar。--exclude の位置で効かないことがあるので、対象より前に置く。日本語名は UTF-8 のまま入れる。 |
| 16 | rsync | 同期する | -av --delete | 送り元の末尾スラッシュで意味が変わる。--delete は消える側を先に -n で確認する。 |
| 19 | curl | HTTP を叩く | -sS --fail-with-body | -s だけだと失敗が無言で通る。-S で理由を出し、--fail-with-body で 4xx と 5xx を異常終了にする。 |
| 20 | jq | JSON を読む | -r '.items | length' | -e を付けると null と false が異常終了になる。// は既定値で、欠けた鍵を埋められる。 |
| 23 | kill | 止める | -TERM → -KILL | まず TERM を送って終了を待つ。KILL は後始末を飛ばすので、ロックファイルが残る。 |

結線の例
一本の線は、一つの目的のために引きます。ここでは、現場で何度も書き直すことになる二本を 採りました。どちらも、途中の一箇所を落とすと静かに壊れます。
日本語名を含む一覧を、壊さずに数える
find . -type f -print0 | xargs -0 -n1 basename | sort | uniq -d
名前の区切りを改行ではなく NUL に変えて渡します。空白を含むディレクトリ名や、 全角の空白が入った名前でも、この形なら途中で切れません。最後の 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 が切り出す位置がずれます。 複数ファイルを渡すときは必ず -h を付けます。
終了コードの目盛り
端末の道具は、成功を 0 で、失敗を 0 以外で返します。この一段だけを覚えておくと、 スクリプトの分岐が読みやすくなります。数字は 8 ビットに収まる範囲で、128 を超えるものは シグナルによる終了です。
| 値 | 意味 | よくある原因 |
|---|---|---|
| 0 | 成功 | grep は該当があった場合。何も見つからないと 1 を返す。 |
| 1 | 一般的な失敗 | diff と grep では「差分あり/該当なし」の意味。 |
| 2 | 使い方の誤り | オプションの綴り違い、引数の不足。 |
| 126 | 実行できない | 権限はあるが実行形式でない、または権限が足りない。 |
| 127 | 見つからない | PATH に無い。綴りか環境変数の受け渡しを疑う。 |
| 130 | Ctrl-C | 128 + 2。SIGINT で止められた。 |
| 137 | 強制終了 | 128 + 9。メモリ不足で落とされた場合もここに来る。 |
| 143 | 正常な停止 | 128 + 15。TERM を受けて自分で終了した。 |
直前に走ったコマンドの値は echo $? で見られます。パイプの途中の値は、pipefail を 有効にしていない限り最後のコマンドのものだけが残ります。
日本語環境で、静かに壊れる四箇所
英語の解説をそのまま写すと、ここで一度は転びます。どれもエラーメッセージを出さずに 結果だけを変えるので、表の側に貼っておく価値があります。
1. 先頭の BOM
Excel から書き出した CSV は、先頭に EF BB BF の三バイトが付きます。jq はこの 三バイトで即座に失敗し、awk は最初の列名を壊します。確認は先頭三バイトを見るだけです。
head -c 3 data.csv | od -An -tx1
2. CRLF の改行
Windows で保存したシェルスクリプトは、行末の CR のせいで bad interpreter になり ます。file で CRLF を確かめ、BSD の sed なら次の形で落とします。
file deploy.sh && sed -i '' $'s/\r$//' deploy.sh
3. ロケールの切り替え
LC_ALL=C を付けると grep と sort は目に見えて速くなります。ただし日本語の 文字境界が壊れ、sort の並びも符号の順になります。日本語を含む対象では付けません。
LC_ALL=ja_JP.UTF-8 sort -k1,1 names.txt
4. 全角の空白と分解文字
全角の空白は U+3000 で、半角の空白とは別の文字です。また macOS のファイル名は 濁点が分解された形で保存されることがあり、目で見て同じ「バ」でも一致しません。
printf '%s' ' ' | od -An -tx1
逆引(やりたいことから)
逆引表の全体を見るコマンド名を忘れたときは、こちらから引きます。左の列は、作業中に頭に浮かぶ言葉のままです。
| やりたいこと | 端子 | 一行 |
|---|---|---|
| 文字列を含むファイルを名前付きで探す | 05 grep | grep -rln --include='*.ts' 'TODO' . |
| 三日以内に変わった設定ファイルを探す | 04 find | find /etc -type f -newermt '-3 days' |
| CSV の三列目を数値として並べる | 09 sort | sort -t, -k3,3n data.csv |
| 標準エラーだけ捨てる | リダイレクト | command 2>/dev/null |
| 直前のコマンドの終了コードを見る | シェル | echo $? |
| ポート 3000 を使っているプロセスを探す | lsof | lsof -nP -iTCP:3000 -sTCP:LISTEN |
| tar を展開せずに中身を確かめる | 15 tar | tar -tzf backup.tgz | head -30 |
| JSON の配列の件数を数える | 20 jq | jq -r '.items | length' response.json |