Node.js と Docker Compose
Docker Compose(英語) は、マルチコンテナーアプリケーションを実行するために使用されます。例: Web サーバー、バックエンドデータベース、アプリケーションコードを個別のサービスとして実行できます。各サービスは、必要に応じてコンテナーを追加することで拡張できます。これにより、本番環境と同様に、動的な環境で効率的な開発とテストを実行できます。
始める前に
設定 | プラグインページのインストール済みタブで、JavaScript and TypeScript、JavaScript Debugger、Node.js、Node.js リモートインタープリター、Docker の必須プラグインが有効になっていることを確認します。詳細については、プラグインのマッピングを参照してください。
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのマーケットプレースタブに Node.js リモートインタープリタープラグインをインストールして有効にします。
Docker の説明に従って、Docker をダウンロード、インストール、設定します。
Docker Compose で Node.js ランタイムを構成する
Docker の Node.js ランタイムは、Node.js リモートインタープリターの構成ダイアログで設定します。このダイアログは、設定ダイアログの JavaScript ランタイムページから、または Node.js の実行 / デバッグ構成を作成または編集するでアプリケーションを実行またはデバッグする際に開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js ランタイムを設定することです。この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。これにより、Docker で設定された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係の管理、テストの実行、コードの lint チェックも可能になります。以下の npm、pnpm、yarn と Docker、アプリケーションをテストする、Docker を使用した ESLint を参照してください。
Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定ダイアログ(Ctrl+Alt+S)を開き、に移動します。
ノードランタイムフィールドの横にある
をクリックします。

現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。

開いた Node.js リモートランタイムを構成するダイアログで、Docker Compose を選択します。
サーバーリストから、使用する Docker 構成を選択します。

または、フィールドの横にある新規をクリックし、Docker サポートを有効にする説明に従って Docker サーバーを構成します。
構成ファイルフィールドで、使用する docker-compose 構成ファイルを指定します。「参照」をクリックし、表示される「Docker Compose 構成ファイル」ダイアログで構成ファイルのリストを作成します。

サービスリストから、使用するサービスを選択します。

OK をクリックすると、Node.js インタープリターダイアログに戻り、新しいランタイムがリストに追加されます。新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでそのランタイムを選択し、OK をクリックして JavaScript ランタイムダイアログに戻ります。

PhpStorm は、たとえば実行 / デバッグ構成を作成するときに、ノードランタイムリストから Project エイリアスを選択するたびに、このインタープリターを自動的に使用します。
新しいランタイムに関連付けられたパッケージマネージャーをプロジェクトの依存関係の管理に使用するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。そのためには、パッケージマネージャーフィールドにパッケージマネージャーの場所を指定します。詳しくはプロジェクト内のデフォルトの Node.js ランタイムとパッケージマネージャーを指定するを参照してください。
プロジェクト内のデフォルトの Node.js ランタイムとパッケージマネージャーを指定する
PhpStorm は、実行 / デバッグ構成の作成時など、ノードランタイムリストから Project エイリアスを選択するたびに、デフォルトのプロジェクトインタープリターを自動的に使用します。
デフォルトのプロジェクトパッケージマネージャーは、依存関係を管理するために自動的に使用されます。たとえば、package.json ファイルから <package manager> install を実行したり、ESLint、Prettier などのサードパーティツールをインストールしたりします。
設定ダイアログ(Ctrl+Alt+S)を開き、に移動します。
ノードランタイムリストから、現在のプロジェクトでデフォルトで使用する構成を選択します。
パッケージマネージャーリストから、使用するパッケージマネージャーに関連付けられているエイリアスを選択します。PhpStorm はその位置を自動的に検出します。

または、必要なパッケージマネージャーの場所を手動で指定します。
npm 実行可能ファイルのデフォルトの場所は
/usr/local/lib/node_modules/npmです。pnpm のデフォルトの場所は、インストール方法によって異なります。
npm を介してインストールするための /usr/local/lib/node_modules/pnpm。
カールを介してインストールするための /usr/local/pnpm-global/<version>/node_modules/pnpm(
curl -f https://get.pnpm.io/<version>.js | node - add --global pnpm)。
詳細については、pnpm 公式 Web サイト(英語)を参照してください。
ヤーンのデフォルトの場所は /opt/yarn-<version>5 で、たとえば /opt/yarn-v1.22.5 です。
Node.js 実行 / デバッグ構成を作成する
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。
ファイルフィールドで、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、Express(英語) アプリケーションの場合は bin/www)。

必要に応じて、Node.js アプリケーションの実行とデバッグで説明されているいくつかのオプション設定を指定します。
ノードランタイムリストから、Docker Compose 経由で関連するリモート Node.js ランタイムを選択します。

または、ノードランタイムフィールドの横にある
をクリックし、上記のようにリモート Node.js ランタイムを構成します。

Docker Compose エリアで、Docker Compose に渡すコマンドとオプションを指定します。デフォルト設定を受け入れるか、「
」をクリックしてカスタム設定 (たとえば、
--rmや--service-portsなどのカスタム Docker Compose フラグ) を指定します。詳細については、Docker オフィシャル Web サイト(英語)を参照してください。コマンドプレビューを確認してください。

関連ページ:
プラグインのインストール
プラグインは PhpStorm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケッ...
Docker
Docker は、分離された再現可能な環境で実行可能ファイルをデプロイおよび実行するためのツールです。これは、たとえば、本番環境と同じ環境でコードをテストする場合に役立ちます。PhpStorm は Docker 機能を統合し、Docker イメージの作成、Docker コンテナーの実行、Docker Compose アプリケーションの管理、パブリックおよびプライベート Docker レジストリの使用など、IDE から直接実行するための支援を提供します。Docker プラグインを有効にするこの機能は...
JavaScript ランタイム
推奨ランタイム:このエリアでは、使用するランタイムを選択します。利用可能なランタイムのセットは、インストールされているプラグインによって異なります。パッケージマネージャー:このフィールドでは、現在のプロジェクトのパッケージマネージャー (npm、Yarn、pnpm、bun) を選択します。PhpStorm は、これらのマネージャーへの現在のシステムパスに、、エイリアスを使用します。カスタムインストールを使用するには、選択をクリックし、関連するパッケージマネージャーのインストールフォルダーを選...
Node.js と Docker
Docker を使用すると、Node.js アプリケーションをすばやくブートストラップして、PhpStorm から実行、デバッグ、プロファイリングできます。IDE は、新しい Dockerfile を自動的に作成し、イメージをビルドして実行し、ソースコードを同期し、コンテナーに npm 依存関係をインストールすることにより、初期構成を処理します。WebStorm と Docker のクイックツアーでいくつかの例を見つけることができます。始める前に:設定 | プラグインページのインストール済みタブで、...
実行 / デバッグ構成: Node.js
作成: 次の Node.js バージョンは、PhpStorm 2023.3 以降でサポートされています。Node.js 22 - アクティブな長期サポート(LTS)バージョン、Node.js 24 - 現在のバージョン、サポートされている Node.js バージョンの詳細を参照してください。このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。始める前に:Node.js をダウンロードしてインストールします。構成タブ:ノードラン...
Node.js の実行とデバッグ
PhpStorm は、Node.js アプリケーションの実行とデバッグを支援します。PhpStorm から起動し、すでに実行中のアプリケーションにアタッチするアプリケーションをデバッグできます。始める前に:JavaScript and TypeScript、JavaScript Debugger、Node.js に必要なプラグインが設定 | プラグインページのインストール済みタブで有効になっていることを確認します。詳細については、プラグインのマッピングを参照してください。Node.js アプリケ...