--helpオプションの使い方【Linuxコマンド完全ガイド】

--helpオプションとは?基本的な意味と役割

「このコマンド、どう使うんだっけ?」と思ってGoogle検索に飛ぼうとした経験、ありますよね。筆者もLinuxを使い始めた頃、そのたびにブラウザとターミナルを行ったり来来していました。でも --help を覚えてからは、ターミナルを離れる回数が体感で7割以上減りました。

--help は、コマンド名の後ろにつけるだけでそのコマンドの使い方・オプション一覧を端末上に即表示してくれるオプションです。GNU(GNUプロジェクト)の規約に基づいた標準的な「ロングオプション」で、ls・grep・cp・mkdirといった外部コマンドはもちろん、多くのコマンドが対応しています。

初心者が最初に覚えるべき理由はシンプル。ネット検索より速く、オフラインでも使えて、今インストールされているバージョンの正確な情報が出てくるからです。


--helpオプションの基本的な使い方と実行例

基本書式:コマンド名 --help

書式はこれだけです。

コマンド名 --help

実行すると「Usage(使い方の書式)」「利用可能なオプション一覧」「簡単な説明」が返ってきます。manページほど詳細ではないぶん、必要な情報だけパッと確認できるのが強みです。

よく使うコマンドでの--help実行例

実際によく使う5つのコマンドで試してみましょう。

ls --help
grep --help
cp --help
mkdir --help
find --help

たとえば ls --help を実行すると、-l(詳細表示)や -a(隠しファイル表示)など30以上のオプションが一覧で出てきます。grep --help では -i(大文字小文字無視)や -r(再帰検索)といった頻出オプションがすぐ確認できます。

-hオプションとの違い・注意点

-h でも同じじゃないの?」と思いがちですが、コマンドによって意味が変わります。たとえば ls -h は「human-readable(人間が読みやすい単位で表示)」の意味で、ヘルプとは無関係です。-h--help の短縮形として機能するかどうかはコマンド次第なので、確実に使いたいなら --help をつける習慣をつけておくのが安全です。


--helpの出力結果の読み方・解釈方法

Usage行・書式表記の読み方

出力の最初に出てくる Usage 行はこんな形式です。

Usage: ls [OPTION]... [FILE]...

ここで覚えておくべき記法が3つあります。

  • [OPTION] のように角括弧で囲まれているものは省略可能
  • 角括弧のない引数は必須
  • ...繰り返し指定できるという意味

オプション一覧部分の読み方

オプション一覧では、短いオプションとロングオプションが並んで表示されます。

  -a, --all              do not ignore entries starting with .

左が短縮形(-a)、右がロングオプション(--all)です。--output=FILE のように =VALUE の形になっている場合は、そのオプションが値を必要とすることを意味します。

出力をgrepやlessで絞り込む実践テクニック

出力が長くて目的のオプションを探せないときは、grep と組み合わせるのが一番速いです。

grep --help | grep color
find --help | less

ただし一部のコマンドは、ヘルプを標準出力ではなく標準エラー出力に出力します。その場合は 2>&1 をつけて解決します。

コマンド名 --help 2>&1 | grep キーワード

筆者はこの 2>&1 の組み合わせを知ってから、ヘルプ探しでハマる時間がほぼゼロになりました。


--helpとmanコマンドの違い・使い分け

比較表で見る--helpとmanの違い

項目--helpman
情報量簡潔・厳選詳細・網羅的
表示速度即時やや遅い(DBアクセス)
ページャなし(標準)lessで自動表示
オフライン対応対応(要インストール)
セクション構成なし1〜8のセクションあり
最小環境での利用△(未インストールも多い)

場面別の使い分けガイド

判断基準はシンプルです。

  • オプション名をさっと確認したい--help
  • 動作の詳細な仕様・使用例を深く知りたい → man
  • DockerコンテナなどのミニマムなLinux環境 → manが入っていないことが多いので --help が頼りに

manは1〜8のセクションに整理されていて、同名のコマンドとシステムコールを区別して調べられるなど奥が深いです。ただ日常的な使い方確認には --help で十分なシーンが多いです。


--helpとhelpコマンド・infoコマンドとの違い

helpコマンド(bash組み込み)との違い

help コマンドはbash組み込みコマンド専用のヘルプツールです。cdechotype などシェル自体に内蔵されたコマンドの説明を出します。

help cd        # bash組み込みのcdの説明
cd --help      # 外部コマンドとして解釈しようとする

--help は外部コマンドにも組み込みコマンドにも広く使えますが、シェル組み込みコマンドの詳細を調べるなら help コマンドのほうが正確な情報が出ます。

infoコマンド・その他のヘルプシステムとの関係

4つのヘルプ手段を整理するとこうなります。

コマンド対象特徴
--helpほぼ全コマンド即時・簡潔
man外部コマンド等詳細・セクション構成
helpbash組み込みのみシェル専用
infoGNUツール中心ハイパーリンク型ナビゲーション

whatis コマンド名 で1行の概要だけ見る方法や、apropos キーワード で関連コマンドを探す方法も覚えておくと便利ですよ。


Linux以外での--helpオプションの使い方

WindowsのコマンドプロンプトとPowerShellでの--help

Windowsの伝統的なヘルプオプションは /? です。

dir /? のように使います。

ただし winget(Windowsのパッケージマネージャー)は --help に対応しており、winget install --help のようにLinuxと同じ感覚で使えます。

WSL(Windows Subsystem for Linux)環境ならそのままLinuxの --help が使えます。

PowerShellには Get-Help という独自のヘルプシステムがあり、こちらは別の体系です。

Git・Docker・npmなど開発ツールでの--help活用

開発ツールでは --help が特に活きます。

git --help                # gitコマンド全体のヘルプ
git commit --help         # サブコマンド単位でヘルプを表示
docker run --help         # dockerのrunサブコマンドのオプション一覧
npm --help                # npmのヘルプ
python --help             # または python -h

筆者はGitを使うとき、オプションをど忘れしたら迷わず git commit --help を打ちます。manページが開くケースもありますが、それはそれで詳しい情報が出るので問題なし。


--helpが効かないときの原因と対処法

--helpに対応していないコマンドの見分け方

古いUNIX系コマンドやBusyBox環境の一部コマンドは --help に対応していません。試してみてエラーが出たり、終了ステータスが0以外の場合は非対応です。その場合は man、info、または公式ドキュメントを当たりましょう。

エイリアスやPATHの問題を確認する方法

--help を打ったのに変な動きをする」という場合、エイリアスが邪魔している可能性があります。

  1. type コマンド名 でそのコマンドの実体を確認する
  2. which コマンド名 でパスを確認する
  3. \コマンド名 --help のようにバックスラッシュをつけてエイリアスを無視して実行する

コマンド自体が見つからない場合は PATH が通っていないか、そもそもインストールされていない可能性が高いです。which コマンド名 で何も返ってこなければインストールを確認してください。


まとめ:--helpを使いこなしてコマンド操作を効率化しよう

--help の要点をまとめます。

  • コマンド名 --help でその場でオプション一覧を確認できる
  • --help | grep キーワード で目的のオプションを素早く絞り込める
  • man(詳細)・help(bash組み込み)・info(GNU詳細)と目的別に使い分けるのが正解
  • Git・Docker・npmなど開発ツールでもほぼ同じ使い方が通用する
  • --help が効かないときは type コマンドでエイリアスやパスを確認する

ターミナルとブラウザを行き来していた時間が、--help の習慣ひとつでかなり短縮できます。まず明日から、オプションを調べたいときは --help を最初に打つクセをつけてみてください。

もっと詳しく知りたい方は → manコマンドの使い方完全ガイド

おすすめの記事