CLion 2026.2 Help

実行 / デバッグ構成: NPM

作成: 実行 | 構成の編集 | 新規構成の追加| NPM

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

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

スクリプトが開発モードでアプリケーションを起動する場合、構成を変更してデバッグセッションも開始することができます。 これを行うには、 ブラウザー / Live Edit タブに移動し、そこでアプリケーションが実行される URL アドレスを指定します。

始める前に

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

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

構成タブ

項目

説明

パッケージ.json​​

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

コマンド

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

スクリプト

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

引数

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

ノードランタイム

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

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

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

Node オプション

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

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

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

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

パッケージマネージャー

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

環境変数

このフィールドでは、Node.js 実行可能ファイル用のカスタム 環境変数を指定します。

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

  • NODE_PATH

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

  • NODE_MODULE_CONTEXTS

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

  • NODE_DISABLE_COLORS

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

環境変数

または、フィールドの右側にある 閲覧 環境変数の編集 をクリックし、表示される 環境変数 ダイアログで変数のリストを設定します:

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

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

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

Docker コンテナーの設定

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

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

Docker Compose

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

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

共通設定

実行構成を編集する場合(ただし実行構成テンプレートは除く)、次のオプションを指定できます:

項目

説明

命名方法名

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

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

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

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

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

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

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

ツールバー

実行 / デバッグ構成のツリービューには、プロジェクト で利用できる構成の管理や、デフォルト構成テンプレートの調整に役立つツールバーがあります。

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

削除ボタン

Alt+Delete

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

コピー

Ctrl+D

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

構成の保存

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

新しいフォルダーに移動する / 新しいフォルダーを作成する

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

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

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

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

構成を並べ替え

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

起動前

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

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

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

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

  • 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 のソースファイルがある場所を指定します。

削除ボタン

Alt+Delete

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

編集

Enter

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

メソッドアップ

メソッドダウン

Alt+Up

Alt+Down

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

このページを表示する

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

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

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

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

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

実行 / デバッグ構成でアプリケーションを開発モードで起動し、同時にデバッグセッションを開始する場合は、このタブのコントロールを使用します。

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

項目

説明

ブラウザーを開く

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

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

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

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

2026 年 7 月 15 日