リモート Node.js インタープリターの構成
PyCharm では、リモートホストまたは仮想環境にインストールされた Node.js でアプリケーションを開発、テスト、リント、実行、デバッグするときに、リモート Node.js インタープリターを構成する必要があります。
リモート Node.js インタープリターは、Node.js リモートインタープリターの構成ダイアログで構成されます。このダイアログは、リモート環境でアプリケーションを実行またはデバッグするための Node.js 実行 / デバッグ構成を作成または編集するときに、設定ダイアログの Node.js ページ以降から開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js インタープリターを構成することです。この場合、プロジェクトのデフォルトとしてインタープリターと関連するパッケージマネージャーを設定できます。
Node.js の実行 / デバッグ構成で直接構成するリモート Node.js インタープリターは、この実行 / デバッグ構成でのみ使用できます。
SSH 接続を介してアクセス可能なホスト上のリモート Node.js インタープリター
始める前に
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、Node.js および Node.js リモートインタープリタープラグインを設定 | プラグインページのマーケットプレースタブにインストールします。
設定で FTP/SFTP/WebDAV 接続プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに FTP/SFTP/WebDAV 接続と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。
SSH 構成を作成する説明に従って、ターゲットリモートホスト上の SSH サーバーへのアクセスを構成し、このサーバーが実行されていることを確認します。
SSH 経由の Node.js インタープリターは、Node.js リモートインタープリターの構成ダイアログで構成されます。このダイアログは、Node.js の実行 / デバッグ構成を作成または編集するを使用してアプリケーションを実行またはデバッグするときに、設定ダイアログの Node.js ページ以降から開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js インタープリターを構成することです。この場合、プロジェクトのデフォルトとしてインタープリターと関連するパッケージマネージャーを設定できます。
Node.js の実行 / デバッグ構成で直接構成するリモート Node.js インタープリターは、この実行 / デバッグ構成でのみ使用できます。
設定で SSH 経由でリモート Node.js インタープリターを構成するダイアログ
設定ダイアログ(Ctrl+Alt+S)を開き、 に移動します。
Node インタープリターフィールドの横にある
をクリックします。

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

開いた Node.js リモートインタープリターの構成ダイアログで、SSH を選択します。
使用する SSH 構成を選択します。

または、
をクリックして、SSH 構成を作成する説明に従って新しい SSH 構成を作成します。
OK をクリックして、新しいインタープリターがリストに追加される Node.js インタープリターダイアログに戻ります。

新しく構成されたインタープリターをプロジェクトのデフォルトとして設定するには、リストでインタープリターを選択し、OK をクリックして Node.js ダイアログに戻ります。
PyCharm は、たとえば実行 / デバッグ構成を作成するときに、Node インタープリターリストから
Projectエイリアスを選択するたびに、このインタープリターを自動的に使用します。新しいインタープリターに関連付けられたパッケージマネージャーを使用してプロジェクトの依存関係を管理するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。これを行うには、パッケージマネージャーフィールドでパッケージマネージャーの場所を指定します。
npm 実行可能ファイルのデフォルトの場所は
/usr/local/lib/node_modules/npmです。
実行 / デバッグ構成で SSH 経由でリモート Node.js インタープリターを構成する
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。
Node インタープリターフィールドの横にある
をクリックします。

Node.js インタープリターダイアログが開きます。
ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。

上記のように、 SSH 経由でリモート Node.js インタープリターを構成します。
Docker コンテナー内のリモート Node.js インタープリター
始める前に
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、Node.js および Node.js リモートインタープリタープラグインを設定 | プラグインページのマーケットプレースタブにインストールします。
設定で Docker プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに Docker と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。
Docker の説明に従って、Docker をダウンロード、インストール、設定します。
Docker の Node.js インタープリターは、Node.js リモートインタープリターの構成ダイアログで構成されます。このダイアログは、Docker でアプリケーションを実行またはデバッグするために Node.js の実行 / デバッグ構成を作成または編集するを実行するときに、設定ダイアログの Node.js ページから開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js インタープリターを構成することです。この場合、プロジェクトのデフォルトとしてインタープリターと関連するパッケージマネージャーを設定できます。その結果、Docker で構成された Node.js インタープリターを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係を管理し、テストを実行し、コードをリントすることもできます。
Node.js の実行 / デバッグ構成で直接構成するリモート Node.js インタープリターは、この実行 / デバッグ構成でのみ使用できます。
設定で Node.js インタープリターを構成するダイアログ
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。
開いた実行 / デバッグ構成: Node.js ダイアログで、Node インタープリターフィールドの横にある
をクリックします。
現在構成されているすべてのインタープリターのリストが表示された Node.js インタープリターダイアログで、ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。
開いた Node.js リモートインタープリターの構成ダイアログで、Docker オプションを選択します。
サーバーフィールドに、使用する Docker の設定を指定します。詳細については、Docker での作業: プロセスの概要を参照してください。リストから構成を選択するか、
をクリックして、開いた Docker ページ上に新しい構成を作成します。
イメージ名: フィールドで、使用するベース Docker イメージを指定します。リストから以前にダウンロードしたイメージまたはカスタムイメージのいずれかを選択するか、
node:argonやmhart/alpine-nodeなどのイメージ名を手動で入力します。後で実行構成を起動すると、Docker はマシン上で指定されたイメージを検索します。検索が失敗した場合、イメージは Docker レジストリページの Docker 公式イメージ(英語)リポジトリからダウンロードされます。Node.js インタープリターのパスフィールドには、指定されたイメージからのデフォルトの Node.js インタープリターの場所が表示されます。
OK をクリックすると、PyCharm は Node.js リモートインタープリターの構成ダイアログを閉じ、新しいインタープリター構成がリストに追加される Node.js インタープリターダイアログに移動します。OK をクリックして、実行構成に戻ります。
Node.js の実行 / デバッグ構成で Node.js インタープリターを構成する
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。
Node インタープリターフィールドの横にある
をクリックします。Node.js インタープリターダイアログが開きます。
ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。

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

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

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

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

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

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

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

または、必要なパッケージマネージャーの場所を手動で指定します。
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 実行 / デバッグ構成で Docker Compose 定義を使用して Node.js インタープリターを構成する
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。
ファイルフィールドで、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、Express(英語) アプリケーションの場合は bin/www)。

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

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

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

関連ページ:
Node.js
このページは、プラグインのインストールに従って、設定 | プラグインページのインストール済みタブで Node.js バンドルプラグインが有効になっている場合にのみ表示されます。次の Node.js バージョンは、PyCharm 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細情報 Node インタープリターこのフィールドでは、現在のプロジ...
Node.js
Node.js は、サーバーやコマンドラインなど、ブラウザーの外部で JavaScript を実行するための軽量ランタイム環境です。PyCharm は Node.js と統合されており、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、保守を支援します。Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、Node.js をインストールす...
プラグインのインストール
プラグインは PyCharm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケット...
実行 / デバッグ構成: Node.js
作成: 次の Node.js バージョンは、PyCharm 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細を参照してください。このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。始める前に:Node.js をダウンロードしてインストールします。JetBrains...
Docker
Docker は、分離された再現可能な環境で実行可能ファイルをデプロイおよび実行するためのツールです。これは、たとえば、本番環境と同じ環境でコードをテストする場合に役立ちます。PyCharm は Docker 機能を統合し、Docker イメージの作成、Docker コンテナーの実行、Docker Compose アプリケーションの管理、パブリックおよびプライベート Docker レジストリの使用など、IDE から直接実行するための支援を提供します。Docker コンテナーにデプロイされたさまざま...
Docker 接続設定
PyCharm から Docker エンジン API にアクセスするための設定を指定します。Docker と PyCharm の統合の使用方法の詳細については、「Docker」を参照してください。Docker プラグインを有効にするこの機能は、デフォルトで PyCharm にバンドルされて有効になっている Docker プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、Doc...