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

--helpオプションとは?基本動作と実行方法

Linuxを触り始めたころ、「このコマンドってどう使うんだっけ?」って毎回ググってた記憶、ありませんか。筆者もそうでした。でも実は、ターミナルを開いたままその場で調べる方法が最初から用意されています。それが --helpオプション です。

ほぼすべてのLinuxコマンドに搭載されている機能で、実行するとコマンドの概要・使い方・主要オプションが標準出力にそのまま表示されます。GNUプロジェクトが慣習として整備してきたもので、現代的なLinuxディストリビューションなら大体使えます。ブラウザを開かなくていいので、作業の流れを止めずに調べられるのが最大の強みです。

--helpの基本構文と書式

書き方はシンプル。

コマンド名 --help

ハイフンは必ず2つです。-help(ハイフン1つ)と書いてもエラーになるか、全く別の意味に解釈されることがあります。一部のコマンドは -h という短縮形でも同じヘルプが表示されますが、互換性は保証されていないので、迷ったら --help を使っておけば間違いなし。

実際の実行例:ls --help の出力を見てみよう

ls --help

を実行すると、オプション一覧がズラッと流れてきます。出力が長すぎて読み切れないときは、パイプで less に渡しましょう。

ls --help | less

スペースキーでページ送りできます。特定のオプションを探したいなら grep との組み合わせが便利で、たとえば並び替え関係のオプションだけ絞り込みたいときは次のように書きます。

ls --help | grep sort

--helpで表示される情報の読み方【NAME・SYNOPSIS・OPTIONS】

「--helpを実行したら文字が大量に出てきて、何を見ればいいかわからない」——これ、初心者あるあるですよね。筆者も最初は上から全部読もうとして挫折しました。でも構造を把握すれば、必要な情報を10秒以内に見つけられます。

Usage(SYNOPSIS)セクションの読み方

ヘルプの冒頭に必ずある Usage: の行が一番重要。基本的な構文が凝縮されています。

記法のルールはこうです。

  • [オプション] → 角括弧は省略可能
  • FILE など大文字 → 可変の引数(自分で値を入れる)
  • ...繰り返し可能(複数指定できる)

たとえば cp --help のUsage行を見ると、コピー元とコピー先をどの順番で書けばいいかが一瞬でわかります。

OPTIONSセクションの読み方

オプション一覧は -r, --recursive のようにショートオプションとロングオプションがセットで並んでいます。引数を取るオプションは -n NUM--lines=NUM のように書かれていて、NUM部分を実際の数値に置き換えて使います。デフォルト値が設定されているものは括弧内に記載されていることが多いので、そこも見落とさずに。

NAME・DESCRIPTION・その他セクションの見方

NAMEには1行でそのコマンドが何をするものか書いてあります。「このコマンドって何だっけ?」という確認だけなら、NAMEだけ読めば十分。末尾の「Report bugs to」の行にはバグ報告先やバージョン情報が載っていて、動作がおかしいときの手がかりになります。


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

Linuxのヘルプ手段は --help だけじゃありません。man、info、apropos、whatisと複数あって、最初は混乱しますよね。筆者は「とりあえず --help → 足りなければ man」という流れで9割の疑問を解決しています。

manコマンドとの比較:詳細を調べるならman

--help はあくまでクイックリファレンス。man コマンドはページャで開く詳細マニュアルで、オプションの細かい挙動や注意点まで書かれています。man には man 1(ユーザーコマンド)や man 5(設定ファイル)のようなセクション番号があり、同じ名前でも異なる対象を参照できます。

infoコマンド・aproposコマンドとの違い

info はGNUプロジェクトが整備したハイパーテキスト形式のマニュアルで、チュートリアル的に読み進められます。apropos はやりたいことはわかっているがコマンド名が思い出せないときの逆引きツール。whatis は1行の説明だけを返すので、コマンドの概要を瞬時に確認したいときに使います。

使い分け早見表:目的別おすすめヘルプコマンド

やりたいこと使うコマンド
オプションをサッと確認--help
詳細な仕様を知りたいman
チュートリアル的に読むinfo
コマンド名がわからないapropos
1行の概要だけ見たいwhatis

--helpの実践的な活用テクニック5選

使い方を知っているだけじゃもったいない。筆者が実際に作業スピードを上げるために使っているテクニックを紹介します。

grepやlessとのパイプ連携で目的の情報を素早く見つける

前述の通りですが、ヘルプ出力を grep でフィルタリングするのは本当に使えます。コマンドによっては --help の出力が標準エラー出力に流れることがあるので、その場合は以下の書き方で対処できます。

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

2>&1 で標準エラーを標準出力にまとめてから grep に渡す——これを知るだけでつまずくケースが激減します。

シェルビルトインコマンドのヘルプ(helpコマンド)

cdexport などはシェルに組み込まれたビルトインコマンドなので、--help が効かないことがあります。bash なら help cd と打てばヘルプが表示されます。対象がビルトインかどうか怪しいときは type cd で確認してみてください。外部コマンドかビルトインかが一発でわかります。

エイリアスやスクリプトで--helpを活用する小技

自作のシェルスクリプトに --help を実装するなら case 文が定番パターンです。また、tldr というコマンドを入れると --help より短くて実践的な例が見られるので、補完ツールとして超おすすめ。筆者は tldr を入れてから「コマンドの使い方を調べる時間が体感で半分以下」になりました。


Windowsコマンドラインでのhelpコマンドの使い方

「--help」で検索しているWindowsユーザーのために触れておきます。Windows環境では仕組みが異なります。

コマンドプロンプトでのhelpコマンドとコマンド名 /?

コマンドプロンプトでは help と打つだけで使用可能なコマンド一覧が出ます。個別コマンドのヘルプは /? オプションを使います。

dir /?

Linux の --help に相当するのがこの /? です。

PowerShellでのGet-Helpコマンドレット

PowerShell では Get-Help コマンドレットがヘルプの入り口になります。Get-Help -Online と付けるとブラウザが開いて公式オンラインドキュメントに飛べる——これはLinuxにはない機能で便利です。Linuxがコマンド単体で完結するのに対し、PowerShellはオンラインと連携する設計になっています。


--helpが使えない・表示されない場合のトラブルシューティング

「--help って打ったのにエラーが出た」という状況は、特に環境構築したてのときによく起きます。

「command not found」や「unrecognized option」が出る場合

command not found が出たならコマンド自体がインストールされていません。

unrecognized option はコマンドは存在するけれど --help をサポートしていないケース。

BusyBox環境(組み込みLinuxなど)では多くのコマンドが --help を持っていないので、その場合は man に切り替えましょう。

あと単純なタイプミス——ハイフンの数(---)は必ず確認してください

シェルビルトインコマンドで--helpが効かない場合の対処

bash では多くのビルトインで --help が動きますが、zsh や sh では挙動が異なります。対処法は help コマンド名man bash 内での検索。whichtype でコマンドの素性を確認する習慣をつけておくと、こういうトラブルで詰まる時間がグッと減ります。


まとめ:--helpを使いこなしてLinuxコマンドを自力で調べよう

記事の要点を整理します。

  • --help はLinuxほぼ全コマンドに使える最速のヘルプ確認手段
  • ハイフンは必ず2つ、出力が長ければ lessgrep と組み合わせる
  • 詳細が必要なら man、逆引きしたいなら apropos と使い分ける
  • ビルトインコマンドには help コマンド名 で対応
  • Windowsでは /?Get-Help がそれぞれ対応する

ググる前にまず --help——この習慣が身につくと、ドキュメントを読む速度が目に見えて上がります。最初は読み方に戸惑っても、10回使えば感覚が掴めます。今日から試してみてください。

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

おすすめの記事