WebStorm 2026.1 Help

TODO コメント

将来参照するために、コードの一部をマークする必要があることがあります。最適化や改善の対象、変更の可能性、議論すべき質問などです。 WebStorm では、 ハイライトされ、エディターで表示され、プロジェクト分析時にインデックスされ、 TODO ツールウィンドウに一覧表示される特別な種類のコメントを追加できます。 このようにしてチームメンバーと一緒に対応が必要な課題を把握できます。

TODO コメントの例
  1. 1 行の TODO コメント

  2. 複数行の TODO コメント

  3. 通常のコメント行

  4. TODO ツールウィンドウ

  5. TODO アイテム

デフォルトで、WebStorm によって認識されるパターンは TODOFIXME の 2 種類あり、小文字と大文字の両方に対応しています。 これらのパターンは行内で使用でき、サポートされている任意のファイルタイプのコメントをブロックできます。 デフォルトのパターンを変更するか、必要に応じ て独自のパターンを追加できます

作業している言語の標準のコメントスタイルを使用して TODO を記述します。 Markdown では、 コメントをエミュレートできます。

複数行の TODO アイテムを作成する

  • 最初のコメント行に続くコメント行のテキストをインデントします。

    複数行の TODO アイテムをインデントするには、スペースとタブ、または両方を組み合わせて使用できます。

複数行の TODO アイテムを無効にする

  1. Ctrl+Alt+S を押して設定を開き、 エディター | TODO を選択します。

  2. 次の行のインデントされたテキストを同じ TODO の一部として扱う チェックボックスをオフにします。

TODO アイテムを表示する

  • TODO ツールウィンドウを開きます: 表示 | ツールウィンドウ | TODO

タブを使用して、表示する TODO アイテムのソースを以下から切り替えます:現在のプロジェクト内のすべてのファイル、現在のファイル内のもののみ、特定の スコープに基づくファイル、または アクティブな変更リスト内のファイル(バージョン管理統合が構成されている場合)。

ソースコード内の TODO コメントに移動するには、 TODO ツールウィンドウで対応する TODO 項目をクリックします。 この動作を無効にするには、ツールバーの シングルクリックで移動 ボタン シングルクリックでナビゲートボタン を使用します(この場合、TODO 項目をダブルクリックして関連するコメントに移動する必要があります)。

カスタムパターンを追加して TODO アイテムをフィルタリングする

独自のパターンを追加してリストをフィルタリングし、特定のパターンに一致する TODO アイテムのみを表示できます。 例: OPTIMIZE パターンでコード内の可能な最適化の場所をマークし、 TODO ツールウィンドウで表示するときに他のすべての TODO アイテムを無視することを選択できます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で、 エディター | TODO を選択します。

  2. 正規表現を使用して、カスタムパターンを指定します。

    例: コメントに OPTIMIZE という単語のパターンを追加するには、 TODO ダイアログの パターン セクションで 追加ボタン をクリックし、次の正規表現を入力します。

    \boptimize\b.*

    これは「optimize」という単語 (\b は単語の境界を指定します) と一致し、コメント内に他の文字をいくつでも含めることができます。

    次に、 OK をクリックして新しいパターンを保存します。

  3. フィルターを追加して TODO パターンをグループ化し、 TODO ツールウィンドウで対応する TODO アイテムを個別に表示します。

    例: Optimization フィルターを新しいパターンで追加するには、 TODO ダイアログの フィルター セクションで 追加ボタン をクリックし、その名前として Optimization を指定し、このフィルターに含める新しいパターンを選択します。

    次に、 OK をクリックして新しいフィルターを保存します。

    TODO 設定ダイアログ
  4. OK をクリックして、 TODO 設定ダイアログで変更を適用します。

  5. 新しいフィルターを適用するには、 TODO ツールウィンドウで 「フィルター TODO 項目」ボタン をクリックし、 Optimization フィルターを選択します。

パターン用に選択したアイコンは、さまざまな TODO アイテムを区別しやすくするために、 TODO ツールウィンドウに表示されます。 パターンの 大 / 小文字の区別 チェックボックスを有効にすることにより、指定された大文字と小文字のみをパターンに一致させることができます。

2026 年 6 月 8 日