PyCharm 2024.3 ヘルプ

実行 / デバッグ構成: NPM

作成: 実行 | 実行構成の編集 | Add New Configuration | NPM

このダイアログでは、npm(英語) および Yarn(英語) スクリプトをローカルで実行するための構成を作成します。現在のコンテキストにおける「ローカル」とは、PyCharm 自体がコンピューターにインストールされている Node.js を起動し、その後スクリプトの実行を開始することを意味します。

npm、pnpm、Yarn の詳細を参照してください。

スクリプトが開発モードでアプリケーションを起動する場合、構成を変更してデバッグセッションも開始することができます。これを行うには、ブラウザー / ライブ編集タブに移動し、アプリケーションが実行される URL アドレスを指定します。詳細については、単一の npm 実行 / デバッグ構成で Angular アプリケーションを実行およびデバッグする単一の npm 実行 / デバッグ構成で Vue.js アプリケーションを実行およびデバッグする単一の npm 実行 / デバッグ構成で Vite アプリケーションを実行およびデバッグするを参照してください。

始める前に

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

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

構成タブ

項目

説明

package.json

このフィールドでは、スクリプトの実行元となる package.json ファイルを指定します。現在のプロジェクトで検出されたすべての package.json ファイルを表示するドロップダウンリストからファイルを選択するか、the Browse button をクリックして、開いたダイアログで必要な package.json を選択します。

コマンド

このリストから、実行する npm CLI コマンドを選択します。デフォルトでは、run-script が選択されています。詳細については、npm のドキュメント(英語)CLI コマンドセクションを参照してください。

スクリプト

このドロップダウンリストから、選択したコマンドを適用するスクリプトを選択します。このリストには、package.json ファイルの scripts プロパティで定義されているすべてのスクリプトが含まれています。

引数

このフィールドで、スクリプトを実行するコマンドライン引数を指定します。詳細については、npm の公式 Web サイト(英語)を参照してください。

Node インタープリター

このフィールドで、使用する Node.js インタープリターを指定します。

プロジェクトエイリアスを選択すると、PyCharm は Node.js ページの Node インタープリターフィールドからプロジェクトの既定のインタープリターを自動的に使用します。ほとんどの場合、PyCharm はプロジェクトの既定のインタープリターを検出し、フィールド自体に入力します。

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

Node オプション

このフィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。受け入れ可能なオプションは次のとおりです。

  • 実行中に CoffeeScript ファイルをオンザフライで JavaScript にコンパイルするには、--require coffeescript/register を使用します。

    このモードでは、coffeescript パッケージの一部である register.js ファイルがプロジェクト内に配置されている必要があります。CoffeeScript コンパイラーをインストールするの説明に従って、coffeescript パッケージがローカルにインストールされていることを確認してください。

  • Chrome デバッグプロトコル(英語)サポートには --inspect または --inspect-brk パラメーターを使用します。

パッケージマネージャー

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

環境変数

このフィールドで、必要に応じて Node.js 実行可能ファイルの環境変数(英語)を指定します。フィールドの右側にある参照 the Browse button をクリックし、環境変数ダイアログで変数のリストを構成します。次のように開きます。

  • 新しい変数を定義するには、the Add button をクリックして、変数の名前と値を指定します。

  • 変数定義を破棄するには、リストでそれを選択して the Remove button をクリックします。

  • 準備ができたら、OK をクリック

変数の定義は、環境変数読み取り専用フィールドにセミコロンを区切り文字として表示されます。例:

  • NODE_PATH : モジュール検索パスの前に付いたディレクトリの : -separated リスト。

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

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

Docker コンテナーの設定

この読み取り専用フィールドには、ポートとボリュームのバインディングが表示されます。the Expand button をクリックして、コマンドプレビューを開きます。

Check Docker container settings

Docker Compose

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

コマンドプレビューを確認してください。

共通設定

実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。

項目

説明

名前

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、PyCharm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

プロジェクトファイルとして保存

実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、.idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

デフォルトでは無効になっており、PyCharm は実行構成設定を .idea/workspace.xml に保存します。

ツールバー

実行 / デバッグ構成のツリー表示には、プロジェクトで使用可能な構成を管理したり、デフォルトの構成テンプレートを調整したりするのに役立つツールバーがあります。

項目

ショートカット

説明

the Add button

Alt+Insert

実行 / デバッグ構成を作成します。

the Remove button

Alt+Delete

選択した実行 / デバッグ構成を削除します。デフォルト設定は削除できません。

Copy

Ctrl+D

選択した実行 / デバッグ構成のコピーを作成します。デフォルト設定のコピーを作成してください。

Save configuration

このボタンは、一時的な構成を選択した場合にのみ表示されます。このボタンをクリックして、一時的な構成を永続的なものとして保存します。

Move into new folder / Create new folder

新しいフォルダーに移動 / 新しいフォルダーを作成します。実行 / デバッグ構成は、フォルダーに配置することでグループ化できます。

フォルダーを作成するには、カテゴリ内の設定を選択し、Folder をクリックしてフォルダー名を指定します。カテゴリだけにフォーカスがある場合は、空のフォルダーが作成されます。

次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは Move Up ボタンと Move Down ボタンを使用します。

グループ化を解除するには、フォルダーを選択して Remove Configuration をクリックします。

Sort configurations

このボタンをクリックすると、設定がアルファベット順にソートされます。

起動前

この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。タスクは、リストに表示されている順序で実行されます。

項目

ショートカット

説明

the Add button

Alt+Insert

このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。

  • Web ブラウザーの起動 : ブラウザーを起動するにはこのオプションを選択します。開いたダイアログで、ブラウザーの種類を選択し、開始 URL を入力します。また、ブラウザーを JavaScript デバッガーで起動するかどうかを指定します。

  • 外部ツールの実行 : 外部アプリケーションを実行することを選択します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。PyCharm でまだ定義されていない場合は、定義を追加します。詳細については、「外部ツールおよび外部ツール」を参照してください。

  • 別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。

  • ファイル監視の実行 : PyCharm に現在アクティブなすべての File Watchers を適用させるには、このオプションを選択します。

  • リモート外部ツールの実行 : リモート SSH 外部ツールを追加します

  • Grunt タスクの実行 : Grunt タスクを実行するには、このオプションを選択してください。

    表示される Grunt タスクダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。

    Node.js インタープリターの場所、渡すパラメーター、grunt-cli パッケージへのパスを指定します。

  • gulp タスクの実行 : Gulp タスクを実行するには、このオプションを選択してください。

    表示される Gulp タスクダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。

    Node.js インタープリターの場所、それに渡すパラメーター、gulp パッケージへのパスを指定します。

  • npm スクリプトの実行 : npm スクリプトを実行するには、このオプションを選択してください。

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

  • TypeScript のコンパイル : 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

    • エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。

    • エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。

  • CoffeeScript ソースマップの生成 : CoffeeScript ソースのソースマップを生成するには、このオプションを選択してください。表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。

the Remove button

Alt+Delete

このアイコンをクリックして、選択したタスクをリストから削除します。

Edit

Enter

選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。

Method up

Method down

Alt+Up

Alt+Down

これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。

このページを表示する

実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。

ツールウィンドウをアクティブにする

デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。

それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

ブラウザー / ライブ編集タブ

実行 / デバッグ構成でアプリケーションを開発モードで起動し、同時にデバッグセッションを開始する場合は、このタブのコントロールを使用します。詳細については、単一の npm 実行 / デバッグ構成で Angular アプリケーションを実行およびデバッグする単一の npm 実行 / デバッグ構成で Vue.js アプリケーションを実行およびデバッグする単一の npm 実行 / デバッグ構成で Vite アプリケーションを実行およびデバッグするを参照してください。

ここで、PyCharm を有効にして、ブラウザーでアプリケーションを開くこともできます。

項目

説明

ブラウザーを開く

この領域では、アプリケーションをブラウザーで開くことを有効にします。

  • 起動後 - 起動時にアプリケーションを開くには、このチェックボックスをオンにします。リストから、アプリケーションを開くブラウザーを選択します。

  • URL - このフィールドに、アプリケーションが実行される URL アドレスを指定します。

  • JavaScript デバッガーを使用 - アプリケーションが開発モードで起動されると同時にデバッグセッションを開始するには、このチェックボックスをオンにします。

関連ページ:

npm、pnpm、Yarn

PyCharm は npm、pnpm、Yarn、Yarn 2、Yarn 3 と統合されているため、組み込みのターミナルで、IDE 内から再利用可能なコードのパッケージをインストール、検索、更新、削除できます。PyCharm では、npm、Yarn、pnpm スクリプトを実行およびデバッグすることもできます。PyCharm は、package.json ファイルを解析してスクリプトの定義を認識し、スクリプトをツリービューに表示して、ツリー内のスクリプトと package.json ファイル内のその定義の間...

Angular

Angular は、クロスプラットフォームアプリケーションを構築するための一般的なフレームワークです。PyCharm は Angular のサポートを提供し、新しい Angular アプリの作成やコンポーネントの作業からデバッグやテストまで、開発プロセスのすべてのステップで役立ちます。始める前に:お使いのコンピューターに Node.js がインストールされていることを確認してください。設定 | プラグインページのインストール済みタブで、JavaScript and TypeScript および Angu...

Vue.js

Vue.js は、ユーザーインターフェースと高度な単一ページアプリケーションを開発するためのフレームワークです。PyCharm は、個別のファイル、属性、プロパティ、メソッド、スロット名などで定義されたコンポーネントを含むコンポーネントの Vue.js 対応コード補完を使用して、HTML、CSS、JavaScript の Vue.js ビルドブロックのサポートを提供します。ビルトインデバッガーを使用すると、Vue.js のコードを PyCharm で直接デバッグすることができます。PyCharm は...

Node.js

このページは、プラグインのインストールに従って、設定 | プラグインページのインストール済みタブで Node.js バンドルプラグインが有効になっている場合にのみ表示されます。次の Node.js バージョンは、PyCharm 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細情報 Node インタープリターこのフィールドでは、現在のプロジ...

CoffeeScript

PyCharm では、JavaScript にコンパイルされる CoffeeScript を使用できます。PyCharm は *.coffee ファイルを認識し、それらにのマークを付けます。CoffeeScript コードにブレークポイントを直接設定でき、PyCharm はコンパイル中に生成されたソースマップを使用してブレークポイントを認識します。PyCharm は、キーワード、ラベル、変数、パラメーター、関数の補完を提案することにより、CoffeeScript コードの作成を支援します。シンボルから宣...

Node.js と Docker

Docker を使用すると、Node.js アプリケーションをすばやくブートストラップして、PyCharm から実行、デバッグ、プロファイリングできます。IDE は、新しい Dockerfile を自動的に作成し、イメージをビルドして実行し、ソースコードを同期し、コンテナーに npm 依存関係をインストールすることにより、初期構成を処理します。WebStorm と Docker のクイックツアーでいくつかの例を見つけることができます。始める前に:設定 | プラグインページのインストール済みタブで、J...