PhpStorm 2026.3 Help

npm、pnpm、Yarn

PhpStorm は npm、 pnpm、 Yarn、 Yarn 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. パッケージマネージャー フィールドで、プロジェクトのパッケージマネージャーを指定します。

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

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

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

    Run/Debug Configuration: NPMダイアログの パッケージマネージャー リストから Project エイリアスを選択すると、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 公式 Web サイト を参照してください。

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

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

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

package.json から

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

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

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

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

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

    Node.js が見つかりません

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

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

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

  • ポップアップで '<パッケージマネージャー> のインストール' の実行 をクリックします。

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

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

  • PhpStorm は、 dependencies または devDependencies からのパッケージがインストールされているかどうか、およびそれらのバージョンが指定された範囲と一致するかどうかをチェックするインスペクションも実行します。 インスペクションが不一致を検出した場合、クイックフィックスを提案します。 適用するには、 '<パッケージマネージャー> のインストール' の実行 リンクをクリックします。

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

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

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

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

内蔵ターミナル

コマンドライン シェルまたは埋め込み ターミナル (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 脆弱性データベース(英語)と 全国脆弱性データベース(英語)を調べて、プロジェクトで使用されているパッケージの脆弱性を検出します。 コードを作成すると、IDE は脆弱性があると考えられるパッケージをハイライトし、その説明を提供し、可能な場合は修正を提案します。 検出された脆弱なパッケージのリスト全体が 問題 ツールウィンドウに表示されます。

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

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

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

  2. クイックフィックスを適用するには、 More actions Alt+Enter をクリックして、関連する提案を選択します。

コードを解析して脆弱性のあるすべてのパッケージを検出する

問題ツールウィンドウ: 「脆弱な依存関係」タブ
  • メインメニューで、 コード | コードの解析 | 脆弱な依存関係 を選択します。

  • 結果を 問題 ツールウィンドウの セキュリティ タブで表示します (表示 | ツールウィンドウ | 問題 または Alt+6)。 各項目には説明と重大度の表示が付いています。

  • 特定のパッケージをクリックすると、そのパッケージで見つかった脆弱性に関する詳細情報を確認できます。

  • 安全なパッケージバージョンのリストを表示するには、 Show Safe Dependencies アイコン をクリックします。

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

    結果の取得と問題の解決の詳細を参照してください。

  • 脆弱性を無視するには、 パッケージの脆弱性を無視 リンクをクリックします。

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

デフォルトでは、パッケージの脆弱性チェックは有効になっています。

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

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

デバッグパッケージ

node_modules フォルダー内のパッケージをデバッグできます。

  1. デバッグセッションを開始するための実行/デバッグ構成を開き、 ステップ タブに切り替えます。

  2. ソースマップで指定された既知のサードパーティ製スクリプトにステップインしない および 以下のパターンに一致する URL のスクリプトにステップインしない チェックボックスの選択を解除します。

  3. 必要に応じて ブレークポイントを設定し、 デバッグセッションを開始します。

  4. node_modules フォルダー配下のファイルを含めてコードをステップ実行します。

スクリプト実行

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 をクリックし、コンテキストメニューから <テスト名> の実行 を選択します。

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

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

デバッグモードでスクリプトを起動すると、PhpStorm は デバッグツールウィンドウ を開きます。ここでは、 スクリプトをステップ実行 したり、スクリプトの実行を 一時停止および再開 したり、 中断時に確認 したり、 デバッガーコンソールで JavaScript コードスニペットを実行 したりできます。

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

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

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

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

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

  • Project ツールウィンドウ(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 ファイルへのパスをタイトルに含む新しいノードを追加し、その新しいノードにスクリプトツリーを作成します。

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

ツリーを再構築する

  • 必要なノードに切り替えて、ツールバーの Reload Scripts をクリックします。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    変数の定義は、 環境変数 フィールドにセミコロン(; )で区切って表示されます。例えば:

    • NODE_PATH

      モジュール解決時に検索する追加ディレクトリの一覧です。 リスト内のディレクトリを区切るには、macOS または Linux ではコロン(: )、Windows ではセミコロン(; )を使用します。

    • NODE_MODULE_CONTEXTS

      モジュールを独自のグローバルコンテキストでロードするには 1 に設定します。

    • NODE_DISABLE_COLORS

      REPL の色を無効化するには 1 に設定します。

    環境変数

    または、フィールドの右にある 参照 環境変数の編集アイコン をクリックし、開く 環境変数 ダイアログで変数のリストを設定します:

    • カスタム変数のリストを管理するには、 、 、 、 ボタンを使用します。

    • ダイアログには、使用可能なシステム環境変数のリストも表示されます。 現在の構成でシステム環境変数を使用しない場合は、 システム環境変数を含める チェックボックスをオフにしてください。

    • 準備ができたら OK をクリックします。

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

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

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

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

スクリプトを実行する

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

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

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

  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. 開いたダイアログで、 Before launch エリアの 追加 をクリックし、リストから npm スクリプトの実行 を選択します。

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

デバッグスクリプト

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

いずれの場合も、PhpStorm は デバッグツールウィンドウを開き、そこで スクリプトをステップ実行したり、スクリプトの実行を 一時停止および再開したり、 一時停止中にスクリプトを調べたり、 デバッガーコンソールで JavaScript コードスニペットを実行したりすることができます。

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

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

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

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

PhpStorm は デバッグツールウィンドウを開き、そこで スクリプトをステップ実行したり 、スクリプトの実行を 一時停止および再開したり、 一時停止中にスクリプトを調べたり、 デバッガーコンソールで JavaScript コードスニペットを実行したりすることができます。

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

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

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

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

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

  • Project ツールウィンドウ(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 ファイルへのパスをタイトルに含む新しいノードを追加し、その新しいノードにスクリプトツリーを作成します。

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

ツリーを再構築する

  • 必要なノードに切り替えて、ツールバーの Reload Scripts をクリックします。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    変数の定義は、 環境変数 フィールドにセミコロン(; )で区切って表示されます。例えば:

    • NODE_PATH

      モジュール解決時に検索する追加ディレクトリの一覧です。 リスト内のディレクトリを区切るには、macOS または Linux ではコロン(: )、Windows ではセミコロン(; )を使用します。

    • NODE_MODULE_CONTEXTS

      モジュールを独自のグローバルコンテキストでロードするには 1 に設定します。

    • NODE_DISABLE_COLORS

      REPL の色を無効化するには 1 に設定します。

    環境変数

    または、フィールドの右にある 参照 環境変数の編集アイコン をクリックし、開く 環境変数 ダイアログで変数のリストを設定します:

    • カスタム変数のリストを管理するには、 、 、 、 ボタンを使用します。

    • ダイアログには、使用可能なシステム環境変数のリストも表示されます。 現在の構成でシステム環境変数を使用しない場合は、 システム環境変数を含める チェックボックスをオフにしてください。

    • 準備ができたら OK をクリックします。

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

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

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

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

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

    PhpStorm は デバッグツールウィンドウを開き、そこで スクリプトをステップ実行したり 、スクリプトの実行を 一時停止および再開したり、 一時停止中にスクリプトを調べたり、 デバッガーコンソールで JavaScript コードスニペットを実行したりすることができます。

npm、pnpm、Docker の yarn

PhpStorm を使用すると、ローカルで行うのと同じ方法で、 package.json を編集し、Docker コンテナー内のプロジェクトの依存関係をインストール、更新、削除できます。

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

  2. Node.js および Docker の必須プラグインが 設定 | プラグイン ページで有効化されていることを確認してください。 詳細については、 プラグインの管理を参照してください。

  3. Docker の説明に従って Dockerをダウンロード、インストール、および構成します。

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

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

2026 年 11 月 9 日