実行 / デバッグ構成: Node.js
作成:
次の Node.js バージョンは PyCharm 2023.3 以降でサポートされています:
Node.js 22 - アクティブな長期サポート(LTS)バージョン
Node.js 24 - 現在のバージョン
詳細は サポートされている Node.js バージョン をご覧ください。
このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。
始める前
Node.js をダウンロードしてインストールします。
設定 | プラグイン ページの マーケットプレース タブで Node.js プラグインを、 JetBrains Marketplace からプラグインをインストールするの説明通りにインストールします。
Django Server-specific configuration options
項目 | 説明 |
|---|---|
ノードランタイム | このフィールドでは、使用する Node.js ランタイムを指定します。 ローカル、 リモート Node.js ランタイム、または Linux 用 Windows サブシステム上の Node.js を指定できます。 リストからランタイムを選択するか、 |
Node パラメーター | このフィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。 最も一般的なオプションは次のとおりです。
完全なリストについては、 Node.js コマンドラインオプション(英語)を参照してください。 |
作業ディレクトリ | このフィールドでは、アプリケーションの 作業ディレクトリ(英語)を指定します。 デフォルトでは、フィールドには プロジェクトのルートフォルダーが表示されます。 |
JavaScript ファイル | このフィールドには、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、 Express(英語) アプリケーションの場合は bin/www )。 CoffeeScript をデバッグする場合は、ソースマップを含む生成された JavaScript ファイルへのパスを指定します。 ファイルは外部で生成することも、ファイルウォッチャーを使用したコンパイルを通じて生成することもできます。 詳細については、 CoffeeScript のデバッグを参照してください。 |
アプリケーションパラメーター | このフィールドに、起動時に process.argv(英語) 配列を介してアプリケーションに渡される Node.js 固有の引数を入力します。 |
環境変数 | このフィールドに、必要に応じて Node.js 実行可能ファイルの 環境変数を指定します。 フィールドの右側にある 閲覧
変数の定義は、 環境変数 読み取り専用フィールドにセミコロンを区切りとして表示されます。例えば:
|
Docker コンテナーの設定 | この読み取り専用フィールドには、ポートとボリュームのバインディングが表示されます。 ![]() |
Docker Compose | この領域では、Docker Compose に渡すコマンドとオプションを指定します。 デフォルト設定を受け入れるか、「 コマンドプレビュー を確認してください。 |
ブラウザー / ライブ編集タブ
このタブで、ブラウザーの動作を設定し、アプリケーションのクライアント側コードのデバッグを有効にします。 この機能は JavaScript Debug 実行構成によって提供されます。技術的には、PyCharm はサーバー側コードとクライアント側コード用に別々の実行構成を作成しますが、すべての設定は専用の Node.js 実行構成で指定します。
項目 | 説明 |
|---|---|
ブラウザーを開く | この領域のフィールドに、プロジェクトの HTML ファイルを指定して、内蔵 Web サーバーで起動するプロジェクトルートに従ってこのファイルへの正しい URL を作成します。 例: project_root/inner_folder/index.html を選択した場合、結果の URL は http://localhost:63342/project_root/inner_folder/index.html になります。 起動後 チェックボックスを選択すると、ブラウザーはアプリケーションの起動後にこのページを自動的に開きます。 別の方法として、手動で選択のブラウザーでこの URL アドレスでページを開くことによって同じ結果を見ることができます。 |
起動後 | このチェックボックスを選択すると、ブラウザーが自動的に開きます。 リストから使用するブラウザーを選択します。
|
JavaScript デバッガーを使用 | 選択したブラウザーでクライアントサイドコードのデバッグを有効にするには、このチェックボックスをオンにします。 |
V8 プロファイリングタブ
このタブで V8 CPU とメモリのプロファイリングを有効にします。
項目 | 説明 |
|---|---|
CPU プロファイリング情報を記録する | アプリケーションの起動時に CPU プロファイリングデータの記録を開始するには、このチェックボックスをオンにします。 下の領域のコントロールが有効になります。 以下を指定してください。
|
ヒープスナップショットの取得を許可する | メモリプロファイリングを実行する場合は、このチェックボックスを選択してください。 |
ログ
このタブでは、 実行 ツールウィンドウの コンソール タブに morgan(英語) などのログツールによって生成された情報の表示を有効にします。 詳細については、 Node.js アプリの実行時にログを管理するを参照してください。
共通設定
実行構成を編集するとき(ただし実行構成テンプレートを除く)、次のオプションを指定できます:
項目 | 説明 |
|---|---|
名前 | 実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。 |
Allow multiple instances | この実行構成の複数のインスタンスを並行して実行できるようにします。 デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、PyCharm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。 これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。 |
プロジェクトファイルとして保存 | 実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。 デフォルトの場所は .idea/runConfigurations です。 ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。 デフォルトでは無効になっており、PyCharm は実行構成設定を .idea/workspace.xml に保存します。 |
ツールバー
実行 / デバッグ構成のツリー表示には、project で使用可能な構成の管理や、デフォルトの構成テンプレートの調整に役立つツールバーがあります。
項目 | ショートカット | 説明 |
|---|---|---|
Alt+Insert | 実行 / デバッグ構成を作成します。 | |
Alt+Delete | 選択した実行 / デバッグ構成を削除します。 デフォルト設定は削除できません。 | |
Ctrl+D | 選択した実行 / デバッグ構成のコピーを作成します。 デフォルト設定のコピーを作成してください。 | |
このボタンは、 一時的な構成を選択した場合にのみ表示されます。 このボタンをクリックして、一時的な構成を永続的なものとして保存します。 | ||
新しいフォルダーに移動 / 新しいフォルダーを作成します。 実行 / デバッグ構成は、 フォルダーに配置することでグループ化できます。 フォルダーを作成するには、カテゴリ内の設定を選択し、 次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは グループ化を解除するには、フォルダーを選択して | ||
このボタンをクリックすると、設定がアルファベット順にソートされます。 |
起動前
この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。 タスクは、リストに表示されている順序で実行されます。
項目 | ショートカット | 説明 |
|---|---|---|
Alt+Insert | このアイコンをクリックして、以下の利用可能なタスクのいずれかを追加します:
| |
Alt+Delete | このアイコンをクリックして、選択したタスクをリストから削除します。 | |
Enter | 選択したタスクを編集するには、このアイコンをクリックします。 開いたダイアログで必要な変更を加えます。 | |
Alt+Up Alt+Down | これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。 タスクは、リストに表示されている順に実行されます。 | |
Show this page | 実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。 | |
Activate tool window | デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると 実行または デバッグツールウィンドウが開きます。 それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。 ただし、設定の実行中は、 Alt+4 または Alt+5 を押すことで、対応するツールウィンドウを自分で開くことができます。 | |
ツールウィンドウにフォーカス | 実行 / デバッグ構成を開始したときに、 実行または デバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。 |
