PhpStorm 2026.1 Help

npm、pnpm、Yarn

PhpStorm は npmpnpmYarnYarn 2 、Yarn 3、および Bun と連携します。 組み込みの ターミナルで、IDE 内から再利用可能なコードパッケージをインストール、検索、更新、削除できます。

PhpStorm では、npm、Yarn、pnpm スクリプトの実行およびデバッグも可能です。 PhpStorm は package.json ファイルを解析してスクリプトの定義を認識し、スクリプトをツリービューで表示、ツリー内のスクリプトと package.json ファイル内の定義の間を移動できます。 詳細については、 npm(英語)Yarn(英語)pnpm (英語) の公式 Web サイトを参照してください。

PhpStorm は Yarn ワークスペースを含むプロジェクトを検出し、プロジェクト解析時にワークスペースの package.json ファイルにリストされているがルート node_modules フォルダーに存在するすべての依存関係をインデックス化します。

始める前に

  • Node.js をダウンロードしてインストールします。 npm もインストールされているため、これを使用する場合は、前の手順を完了してください。

  • Yarn を使用するには、 Yarn オフィシャル Web サイト(英語)の説明に従ってインストールしてください。

  • pnpm を使用するには、埋め込まれた ターミナルAlt+F12 )を開き、次のように入力します。

    npm install --g pnpm

    詳細については、 pnpm 公式 Web サイト(英語)を参照してください。

  • Bun を使用するには、 Bun オフィシャル Web サイト(英語)の説明に従ってインストールしてください。

プロジェクトパッケージマネージャーを選択する

PhpStorm では、プロジェクトごとに npm、Yarn、Yarn 2、Bun、pnpm のいずれを使うか選択できます。

デフォルトでは、PhpStorm は npm を提案します。 ただし、 yarn.lock ファイルを含むプロジェクトを開き、コンピューターに Yarn がインストールされている場合、PhpStorm はこのプロジェクトのパッケージマネージャーを自動的に Yarn に変更します。

pnpm-lock ファイルを使用してプロジェクトを開き、pnpm がコンピューターにインストールされている場合、PhpStorm はこのプロジェクトのパッケージマネージャーを自動的に pnpm に変更します。

プロジェクトに bun.lock または bun.lockb ファイルが含まれ、かつコンピューターに Bun がインストールされている場合、PhpStorm はそのプロジェクトで npm の代わりに Bun の利用を提案します。

また、 Yarn 1 または pnpm をデフォルトの PhpStorm パッケージマネージャーとして設定できます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | JavaScript ランタイム に移動します。 JavaScript ランタイムページが開きます。

  2. パッケージマネージャー フィールドで、プロジェクトのパッケージマネージャーを指定します。

    プロジェクトパッケージマネージャーを選択: システムのデフォルトインストールを選択する
    • システムのデフォルトのインストールを使用するには、 npmyarnpnpm 、または bun を選択します。

    • パッケージマネージャーのカスタムインストールを使用するには、 選択 をクリックし、関連するパッケージマネージャーのインストールフォルダーを選択します。

      プロジェクトパッケージマネージャーを選択: カスタムインストールを選択する

    プロジェクト エイリアスを パッケージマネージャー リストから 実行/デバッグ構成: NPMダイアログで選択すると、PhpStorm は選択したパッケージマネージャーを自動的に使用します。 PhpStorm は 'npm install' の実行/実行 'yarn install'/『pnpm install』を実行 コマンドを呼び出したり npm/Yarn/pnpm スクリプトを実行したりするたびに、選択したパッケージマネージャーへのパスも使用します。 詳細については、 スクリプトの実行とデバッグを参照してください。

新しいプロジェクトのデフォルトの PhpStorm パッケージマネージャーを設定する

  1. 新規プロジェクトの設定 ダイアログ(ファイル | 新規プロジェクトのセットアップ | 新規プロジェクト用 設定 )を開き、 言語 & フレームワーク | JavaScript ランタイム に進みます。

  2. 開いた Node.js および NPM ページで、リストから必要なパッケージマネージャーを選択します。

その後、PhpStorm は新しいプロジェクト作成時に選択したパッケージマネージャーをデフォルトとして提案します。

プロジェクトで Yarn 2 を設定する

  1. Yarn 1 がグローバルにインストールされていることを確認し、 Yarn オフィシャル Web サイト(英語)の説明に従って、プロジェクトで Yarn 2 を有効にします。 埋め込まれた ターミナル Alt+F12 を使用して、コマンドを入力します。

  2. 設定 ダイアログ(Ctrl+Alt+S )で、 言語 & フレームワーク | JavaScript ランタイム に移動し、 パッケージマネージャー リストからプロジェクト内の Yarn 2 パッケージへのパスを選択します。

package.json を編集

PhpStorm は package.json ファイルでプロジェクトの依存関係を処理するのに役立ち、広範なコーディング支援を提供します。

  • パッケージ名のコード補完。

    パッケージ名についてはコード補完
  • 利用可能な最新パッケージバージョンの情報。

    利用可能な最新のパッケージバージョンを表示する
  • npm install <package>@<version> または yarn add <package>@<version> を介してインストールできるバージョンの範囲に関する情報。 ` npm install または yarn install を実行すると、この範囲から入手可能な最新バージョンがインストールされます。

    Ctrl を押してバージョンにマウスオーバーすると、ツールチップに情報が表示されます。 セマンティックバージョニングの詳細については、 npm の公式ドキュメント(英語)を参照してください。

    利用可能なパッケージバージョンの範囲を表示する
  • 指定したバージョンのパッケージがインストール済みかどうかの表示と、利用可能な最新バージョンの情報

    パッケージのバージョンがインストールされているかどうかの情報
  • 以前のパッケージバージョンのコード補完。 Ctrl+Space を押すか最新と異なるバージョンを入力し始めると、PhpStorm はそのパッケージの過去の全バージョン候補リストを表示します。

    以前のパッケージバージョンのコード補完
  • パッケージのクイックドキュメント検索。

    パッケージのクイックドキュメント検索

パッケージのインストールと更新

ご存知のとおり、npm では グローバルにも、 プロジェクト依存関係開発依存関係としてもパッケージをインストールできます。詳細は npm 公式サイトをご覧ください。

pnpm でも グローバルプロジェクト依存関係または 開発依存関係としてパッケージをインストールできます。詳細は pnpm 公式サイトをご覧ください。

Yarn を使用すると、パッケージを グローバル(英語)にインストールすることも、 プロジェクトの依存関係としてインストールすることもできます。 詳細については、 Yarn オフィシャル Web サイト(英語)を参照してください。

PhpStorm では、パッケージはエディター、 package.json ファイル、組み込みの ターミナル Alt+F12 、または JavaScript ランタイムページでインストールできます。

package.json から

プロジェクトの依存関係をインストールする

  • ポップアップで 'npm install' の実行実行 'yarn install'『pnpm install』を実行 リンクをクリックします。

    依存関係ポップアップをインストールする

    依存関係が未インストールまたは変更のあった場合、PhpStorm はこのポップアップを表示します。 ポップアップを閉じるか 今後このメッセージを表示しない を選択してポップアップをオフにしても、 『<package_manager> install』を実行する。 アクションまたは 内蔵ターミナルを使用して依存関係をインストールできます。

    PhpStorm が Node.js ランタイムを検出できない場合、エラーは JavaScript ランタイム ページへのリンク付きポップアップで報告され、そのページで Node.js インタープリターを構成できます。

    Node.js が見つかりません

    この通知を誤って閉じてしまい、元に戻したい場合は、 Ctrl+Shift+A を押して Enable notifications と入力し始め、リストから package.json の依存関係のインストールに関する通知を有効化する を選択します。

  • または、関連する package.json ファイルをエディターで開くか、 プロジェクト ツールウィンドウで選択して、コンテキストメニューから 'npm install' の実行 を選択します。

プロジェクトの依存関係を更新する

  • ポップアップで 「パッケージマネージャー install」を実行してください。 をクリックします。

    依存関係の更新: ポップアップ

    プロジェクトを開いたりバージョン管理から更新したり、 package.json を編集するたびに、PhpStorm はこのポップアップを表示します。

  • PhpStorm は 依存関係 または devDependencies からのパッケージがインストール済みか、バージョンが指定範囲内かをチェックするインスペクションも実行します。 インスペクションが不一致を検出した場合、クイックフィックスを提案します。 適用するには、 「パッケージマネージャー install」を実行してください。 リンクをクリックします。

    インストールされているパッケージのバージョンが最新ではありません
  • PhpStorm は新しいバージョンが利用可能なパッケージも検出し、パッケージバージョンにカーソルを合わせた際にクイックフィックスも提案します。

    パッケージを最新バージョンに更新する: ツールチップ

    または、 Alt+Enter を押して、リストから <パッケージ> を最新バージョンに更新する。 を選択します。

    パッケージを最新バージョンに更新する: クイックフィックス

内蔵ターミナル

埋め込まれた ターミナルAlt+F12 )で、次のいずれかのコマンドを入力します。

  • グローバルインストールの場合:

    • npm install&#xa0;--global <package_name>

    • yarn global add <package_name>

    • pnpm --global add <package_name>

  • パッケージをプロジェクト依存関係または開発依存関係としてインストールするには:

    • npm install&#xa0;--save <package_name> または npm install&#xa0;--save-dev <package_name>

    • yarn add <package_name> --dev

    • pnpm add --save-dev <package_name>

package.json ファイルにリストされているすべての依存関係をインストールする

埋め込まれた ターミナルAlt+F12 )で、次のいずれかのコマンドを入力します。

  • npm install

  • yarn install

  • pnpm install

その結果、現在のフォルダーから package.json にリストされているすべての依存関係を取得します。 package.json の編集から詳細を参照してください。

脆弱なパッケージを検出する

PhpStorm は Mend.io 脆弱性データベースおよび National Vulnerability Databaseを横断的に調査し、プロジェクトで使用されているパッケージの脆弱性を検出します。 コードを作成すると、IDE は脆弱性があると考えられるパッケージをハイライトし、その説明を提供し、可能な場合は修正を提案します。 検出された脆弱なパッケージのリスト全体が 問題 ツールウィンドウに表示されます。

脆弱性チェックは、 脆弱な宣言済み依存関係 コードインスペクションによって処理され、これらは パッケージチェッカープラグインに依存しています。 このプラグインは Mend.io(英語) によって提供されています。 このプラグインは PhpStorm にバンドルされており、デフォルトで有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。 詳細については、 プラグイン設定を開く を参照してください。

Detect vulnerable packages and fix them in the editor

エディターでパッケージの脆弱性の問題を解決する

  • package.json ファイル内のハイライトされたパッケージにマウスを置きます。 ポップアップツールウィンドウには、検出された脆弱性の説明が表示されます。

  • クイックフィックスを適用するには、 その他のアクション Alt+Enter をクリックして、関連する提案を選択します。

問題ツールウィンドウで脆弱なパッケージを表示する

  1. インスペクションウィジェットで 問題アイコン をクリックします。

  2. 問題 ツールウィンドウの ファイル タブには、アクティブなエディタータブで開かれている package.json の脆弱なパッケージがすべてリストされます。 各項目には説明が付いています。

    問題を解決するには、リストで脆弱なパッケージを選択し、ツールバーの 黄の電球アイコン をクリックするか、 Alt+Enter を押して、関連する提案を選択します。

  3. 脆弱性のある依存関係 タブには、プロジェクト内で検出されたすべての脆弱なパッケージがリストされます。

    問題ツールウィンドウ: 「脆弱な依存関係」タブ

    問題を修正するには、リストで脆弱なパッケージを選択し、右側のペインで 安全なバージョンをクリップボードにコピー リンクをクリックし、コピーしたバージョンを package.json に貼り付けます。

    詳細は 結果の取得と問題の解決をご覧ください。

パッケージの脆弱性チェックを無効にする

デフォルトでパッケージ脆弱性チェックは有効化されています。

  • これをオフにするには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 エディター | インスペクション に移動し、 セキュリティ ノードの 脆弱な宣言済みの依存関係 インスペクションの横にあるチェックボックスをオフにします。

  • または、 設定 ダイアログ(Ctrl+Alt+S )を開き、 プラグイン に移動し、 パッケージチェッカー プラグインを探して 無効化 をクリックします。

スクリプト実行

npm、Yarn、pnpm スクリプトは、エディターの package.json ファイルから、専用の npm ツールウィンドウのスクリプトツリーから、専用の実行構成に従って、または start-up または before-launch タスクとして自動的に起動できます。

スクリプト実行の結果は 実行ツールウィンドウに表示されます。 ツールウィンドウには、npm または Yarn スクリプトの出力、エラーの報告、見つからなかったパッケージまたはプラグインの一覧などが表示されます。 最後に実行されたスクリプトの名前がツールウィンドウのタイトルバーに表示されます。

スクリプトのデバッグセッションを開始すると、PhpStorm は デバッグツールウィンドウを開きます。ここで スクリプトのステップ実行、 一時停止および再開中断時の調査デバッガーコンソールで JavaScript コードスニペットの実行などが可能です。

package.json からスクリプトを実行する

PhpStorm では package.json ファイルから単一のスクリプトをすばやく起動できます。 いくつかのスクリプトを実行またはデバッグするには、実行構成または npm ツールウィンドウを使用します。

  • エディターで該当する package.json ファイルを開き、スクリプトの横にあるガター内の the Run button をクリックし、コンテキストメニューから 『<script_name>』を実行する。 を選択します。

    package.json からスクリプトを実行 / デバッグする
  • Ctrl+Shift+F10 を押してスクリプトを実行することもできます。

スクリプトの出力は、 実行 ツールウィンドウに表示されます。

デバッグモードでスクリプトを起動すると、PhpStorm は デバッグツールウィンドウを開きます。ここで スクリプトのステップ実行、 停止および再開中断時の調査デバッガーコンソールで JavaScript コードスニペットの実行などが可能です。

npm ツールウィンドウからスクリプトを実行する

プロジェクト ツールウィンドウ(Alt+1 )で package.json ファイルを選択するか、エディターでファイルを開いてコンテキストメニューから npmスクリプトを表示する。 を選択すると、 npm ツールウィンドウが開きます。

npm、pnpm、Yarn を呼び出すとすぐに、ツールは、呼び出された package.json ファイルの スクリプト プロパティ内で定義されたスクリプトのツリーの構築を開始します。

プロジェクトに複数の package.json ファイルがある場合は、それらごとに個別のスクリプトツリーを構築し、以前に構築したツリーを削除せずにスクリプトを実行できます。 各ツリーは個別のノードに表示されます。

npm ツールウィンドウがまだ開いていない場合は開く

  • プロジェクト ツールウィンドウ(Alt+1 )で必要な ファイルを選択するか、エディターでファイルを開き、コンテキストメニューから npmスクリプトを表示する。 を選択します。

    nmp ツールウィンドウを開く

    npm ツールウィンドウが開き、選択または開いた package.json ファイルに従って作成されたスクリプトツリーが表示されます。

すでに開いている npm ツールウィンドウでスクリプトのツリーを構築する

  1. npm ツールウィンドウで、ツールバーの 追加ボタン をクリックし、リストから必要な package.json ファイルを選択します。 デフォルトでは、PhpStorm はプロジェクトのルートに package.json ファイルを表示します。

  2. 別の package.json ファイルがある場合は、 package.json を選択する。 をクリックし、表示されるダイアログで必要な package.json ファイルを選択します。 PhpStorm は選択した package.json ファイルまでのパスをタイトルに持つ新しいノードを追加し、その下にスクリプトツリーを構築します。

別のスクリプトツリーを構築する

ツリーを再構築する

  • 必要なノードに切り替えて、ツールバーの スクリプトの再読み込み をクリックします。

ツリー内のスクリプトを名前でソートする

  • ツールバーの 設定 をクリックし、メニューから 並べ替え を選択してから、 命名 を選択します。

    デフォルトでは、ツリーには、 package.json (オプション 定義順序 )で定義されている順序でスクリプトが表示されます。

1 つのスクリプトを実行する

  • スクリプトをダブルクリックしてください。

  • ツリーでスクリプトを選択して Enter を押すか、コンテキストメニューから <script name> の実行; を選択します。

いくつかのスクリプトを実行する

  • 複数選択モードを使用します:隣接するアイテムの場合は Shift キーを、隣接しないアイテムの場合は Ctrl キーを押しながら、必要なスクリプトを選択し、選択のコンテキストメニューから 実行 または デバッグ を選択します。

    複数のスクリプトを実行する

実行構成によるスクリプトの実行

エディターや npm ツールウィンドウからスクリプトを実行・デバッグすると、PhpStorm は 一時的な実行構成を自動作成します。 使用する以外に、独自の npm 実行構成を作成して起動できます。

NPM の実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集 に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ
  2. 開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから npm を選択します。 実行 / デバッグ構成: npm ダイアログが開きます。

  3. 実行する CLI コマンド、実行するスクリプト(区切り文字として空白を使用)、およびこれらのスクリプトが定義されている package.json ファイルの場所を指定します。 必要に応じて、スクリプトを実行するための コマンドライン引数(英語)を入力します。

  4. パッケージマネージャーのコマンドラインインターフェースの詳細については、 npm 公式 Web サイト(英語)および Yarn オフィシャル Web サイト(英語)を参照してください。

  5. 使用する Node.js ランタイムを指定します。

    プロジェクト エイリアスを選択すると、PhpStorm は JavaScript ランタイムページの ノードランタイム フィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。 ほとんどの場合、PhpStorm はプロジェクトのデフォルトランタイムを検出してフィールドへ自動入力します。

    別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 閲覧ボタン をクリックして新しいインタープリターを構成することもできます。

    必要に応じて、Node.js に渡す Node.js 固有のオプションパラメーター環境変数(英語)を指定します。

  6. 使用するパッケージマネージャーを指定します。 プロジェクト エイリアスを選択すると、PhpStorm は JavaScript ランタイム ページのデフォルトプロジェクトパッケージマネージャーを使用します。 関連するパッケージのエイリアス (npm または yarn) を選択したり、パッケージマネージャーのカスタムインストールへの明示的なパスを指定したりすることもできます。

  7. Docker コンテナーでリモート Node.js ランタイムを使用している場合は、自動生成された Docker コンテナーの設定を確認してください。 展開アイコン をクリックすると、ポップアップで設定が開きます。

    Docker コンテナーの設定を確認する

    npm、pnpm、yarn と Dockerリモート Node.js ランタイムの設定の詳細を参照してください。

スクリプトを実行する

なんでも実行でスクリプトを実行する

なんでも実行は、スクリプトをすばやく開始する方法です。

  1. Ctrl を 2 回押すか、ナビゲーションバーの Run Anything ボタン をクリックします。 何でも実行する ポップアップが開きます。

  2. 検索フィールドにパッケージマネージャーの名前を入力します。 入力すると、PhpStorm が一致するコマンドを表示します。

    なんでも実行: パッケージマネージャーの名前を入力する

    または、スクリプトの名前を入力します。

    なんでも実行: スクリプトの名前を入力する

    最後に、 ? と入力すると、コマンドのヒントのリストが表示されます。

    なんでも実行で使用可能なコマンドのリスト

    関連するヒントに移動し、 Space を押して使用可能なコマンドのリストを取得し、リストから必要なコマンドを選択して、 Enter を押します。

    コマンド出力を 実行 ツールウィンドウに表示するには、 Ctrl+Enter を押し、出力を デバッグ ツールウィンドウに表示するには、 Shift+Enter を押します。

    Run an npm command in the Run or Debug tool window from the Run Anything popup

起動時にスクリプトを自動的に実行する

定期的に実行するスクリプトがいくつかある場合は、対応する実行構成を 起動タスクのリストに追加できます。 タスクはプロジェクトの起動時に自動的に実行されます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で ツール | スタートアップタスク に移動します。

  2. 開いた 起動タスクページで、ツールバーの 追加ボタン をクリックします。

  3. リストから、必要な npm 実行構成を選択します。 設定がリストに追加されます。

    プロジェクトに適用可能な構成がない場合は、 the Add button` をクリックして 実行構成の編集 を選択します。 次に、開いた 実行 / デバッグ構成ページで必要な設定を使用して構成を定義します。 新しい設定を保存すると、自動的に起動タスクのリストに追加されます。

起動前のタスクとしてスクリプトを実行する

  1. メインメニューから 実行 | 実行構成の編集 を選択し 実行 / デバッグ構成ダイアログ ダイアログを開き、リストから必要な構成を選ぶか 新規構成の追加​ をクリックして実行構成タイプを新規作成します。

  2. 開いたダイアログで、 起動前 エリアの 追加 をクリックし、リストから npmスクリプトを実行する。 を選択します。

  3. 開いた NPM スクリプト ダイアログで、 npm 実行 / デバッグ構成設定を指定します。

デバッグスクリプト

npm、Yarn、pnpm スクリプトのデバッグは、エディター内の package.json ファイル、専用の npm ツールウィンドウ内のスクリプトツリー、または専用の実行構成に従って開始できます。

どちらの場合も、PhpStorm は デバッグツールウィンドウを開き、そこで スクリプトをステップ実行したり一時停止および再開一時停止中の調査デバッガーコンソールで JavaScript コードスニペットの実行などが可能です。

package.json からのデバッグスクリプト

PhpStorm では package.json ファイルから単一スクリプトのデバッグセッションを素早く開始できます。 複数のスクリプトをデバッグするには、実行構成または npm ツールウィンドウを使用してください。

  • エディターで該当する package.json ファイルを開き、スクリプトの横にあるガター内の the Run button をクリックし、コンテキストメニューから 『<script_name>』をデバッグする。 を選択します。

    package.json からスクリプトをデバッグする

PhpStorm は デバッグツールウィンドウを開き、 スクリプトをステップ実行一時停止および再開一時停止中の調査デバッガーコンソールで JavaScript コードスニペットの実行などが可能です。

npm ツールウィンドウからスクリプトをデバッグする

プロジェクト ツールウィンドウ(Alt+1 )で package.json ファイルを選択するか、エディターでファイルを開いてコンテキストメニューから npmスクリプトを表示する。 を選択すると、 npm ツールウィンドウが開きます。

npm、pnpm、Yarn を呼び出すとすぐに、ツールは、呼び出された package.json ファイルの スクリプト プロパティ内で定義されたスクリプトのツリーの構築を開始します。

プロジェクトに複数の package.json ファイルがある場合は、それらごとに個別のスクリプトツリーを構築し、以前に構築したツリーを削除せずにスクリプトを実行できます。 各ツリーは個別のノードに表示されます。

npm ツールウィンドウがまだ開いていない場合は開く

  • プロジェクト ツールウィンドウ(Alt+1 )で必要な ファイルを選択するか、エディターでファイルを開き、コンテキストメニューから npmスクリプトを表示する。 を選択します。

    nmp ツールウィンドウを開く

    npm ツールウィンドウが開き、選択または開いた package.json ファイルに従って作成されたスクリプトツリーが表示されます。

すでに開いている npm ツールウィンドウでスクリプトのツリーを構築する

  1. npm ツールウィンドウで、ツールバーの 追加ボタン をクリックし、リストから必要な package.json ファイルを選択します。 デフォルトでは、PhpStorm はプロジェクトのルートに package.json ファイルを表示します。

  2. 別の package.json ファイルがある場合は、 package.json を選択する。 をクリックし、表示されるダイアログで必要な package.json ファイルを選択します。 PhpStorm は選択した package.json ファイルまでのパスをタイトルに持つ新しいノードを追加し、その下にスクリプトツリーを構築します。

別のスクリプトツリーを構築する

ツリーを再構築する

  • 必要なノードに切り替えて、ツールバーの スクリプトの再読み込み をクリックします。

ツリー内のスクリプトを名前でソートする

  • ツールバーの 設定 をクリックし、メニューから 並べ替え を選択してから、 命名 を選択します。

    デフォルトでは、ツリーには、 package.json (オプション 定義順序 )で定義されている順序でスクリプトが表示されます。

1 つのスクリプトをデバッグする

複数のスクリプトをデバッグする

  • 複数選択モードを使用します:隣接するアイテムの場合は Shift キーを、隣接しないアイテムの場合は Ctrl キーを押しながら、必要なスクリプトを選択し、選択のコンテキストメニューから 実行 または デバッグ を選択します。

    複数のスクリプトをデバッグする

実行構成によるデバッグスクリプト

エディターや npm ツールウィンドウからスクリプトを実行・デバッグすると、PhpStorm は 一時的な実行構成を自動作成します。 使用する以外に、独自の npm 実行構成を作成して起動できます。

  1. 実行 | 実行構成の編集 に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ
  2. 開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから npm を選択します。 実行 / デバッグ構成: npm ダイアログが開きます。

  3. 実行する CLI コマンド、実行するスクリプト(区切り文字として空白を使用)、およびこれらのスクリプトが定義されている package.json ファイルの場所を指定します。 必要に応じて、スクリプトを実行するための コマンドライン引数(英語)を入力します。

  4. パッケージマネージャーのコマンドラインインターフェースの詳細については、 npm 公式 Web サイト(英語)および Yarn オフィシャル Web サイト(英語)を参照してください。

  5. 使用する Node.js ランタイムを指定します。

    プロジェクト エイリアスを選択すると、PhpStorm は JavaScript ランタイムページの ノードランタイム フィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。 ほとんどの場合、PhpStorm はプロジェクトのデフォルトランタイムを検出してフィールドへ自動入力します。

    別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 閲覧ボタン をクリックして新しいインタープリターを構成することもできます。

    必要に応じて、Node.js に渡す Node.js 固有のオプションパラメーター環境変数(英語)を指定します。

  6. 使用するパッケージマネージャーを指定します。 プロジェクト エイリアスを選択すると、PhpStorm は JavaScript ランタイム ページのデフォルトプロジェクトパッケージマネージャーを使用します。 関連するパッケージのエイリアス (npm または yarn) を選択したり、パッケージマネージャーのカスタムインストールへの明示的なパスを指定したりすることもできます。

  7. Docker コンテナーでリモート Node.js ランタイムを使用している場合は、自動生成された Docker コンテナーの設定を確認してください。 展開アイコン をクリックすると、ポップアップで設定が開きます。

    Docker コンテナーの設定を確認する

    詳細は npm、pnpm、yarn と Dockerおよび リモート Node.js ランタイムの構成をご覧ください。

  8. ツールバーの 実行 ウィジェットから、新しく作成した実行構成を選択し、その横にある デバッグ をクリックします。

    PhpStorm は デバッグツールウィンドウを開き、 スクリプトをステップ実行一時停止および再開一時停止中の調査デバッガーコンソールで JavaScript コードスニペットの実行などが可能です。

npm、pnpm、Docker の yarn

PhpStorm を利用すれば、 package.json を編集したり、Docker コンテナー内のプロジェクト依存関係をインストール・更新・削除したりをローカル同様に行えます。

  1. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 設定 | プラグイン ページの Marketplace タブに Node.js リモートインタープリタープラグインをインストールして有効にします。

  2. 設定 | プラグイン ページ、 インストール済み タブで、 Node.js および Docker の必要なプラグインが有効になっていることを確認してください。 詳細については、 プラグインの管理を参照してください。

  3. Docker をダウンロード、インストール、構成してください。詳しくは Docker をご覧ください

  4. Docker で Node.js リモートランタイムを構成するまたは Docker Compose 経由でインストールし、プロジェクトの デフォルトとして設定してください。 また、このリモートランタイムに関連付けられたパッケージマネージャーが プロジェクトのデフォルトとして設定されていることを確認してください。

  5. ローカル開発と同様に package.json の編集プロジェクト依存関係の管理スクリプトの実行またはデバッグを行ってください。

2026 年 5 月 22 日