llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

Node.js の実行とデバッグ

CLion helps you run and debug your Node.js applications. You can debug applications that are started from CLion as well as attach to already running applications.

始める前に

  • JavaScript と TypeScript、 JavaScript デバッガー、 Node.js の必須プラグインが 設定 | プラグイン ページで有効化されていることを確認してください。 詳細については、 プラグイン管理を参照してください。

Node.js アプリケーションを実行する

CLion runs Node.js applications according to a run configuration of the type Node.js. CLion also uses this configuration to start the debugger together with Node.js applications.

Node.js 実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集​ に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ

    開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから Node.js を選択します。 実行/デバッグ構成: Node.js ダイアログが開きます。

  2. 使用する Node.js ランタイムを指定します。

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

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

  3. ファイル フィールドで、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、 Express(英語) アプリケーションの場合は bin/www )。

  4. オプション:

    • Node.js の起動をカスタマイズする ノードパラメーター を指定します。 例: 実験的な Node.js 機能を有効にするか、別のオプションを渡すことができます。 詳細については、 Node.js 公式 Web サイト(英語)を参照してください。

    • アプリケーションパラメーター フィールドに、 process.argv(英語) 配列を介して起動時にアプリケーションに渡される Node.js 固有の引数を指定します。

    • ブラウザーでアプリケーションを自動的に開くには、起動前のタスクを設定します。 をクリックして 起動前 領域を展開し、 追加ボタン をクリックして、リストから Web ブラウザーの起動 を選択します。 開いたダイアログで、アプリケーションの開始ページの URL(Express アプリケーションの場合は localhost:3000 など)と使用するブラウザーを指定します。

      起動前のタスク: ブラウザーを開く

アプリケーションの実行

アプリケーションで morgan(英語) などのログツールを使用していて、このツールがログをファイルに書き込む場合、これらのログは 実行 ツールウィンドウの コンソール タブで確認できます。

Node.js アプリケーションの実行時にログを管理する

  1. Node.js の実行 / デバッグ構成を作成し、 ログ タブに移動します。

  2. 利用可能なログファイル(存在する場合)を一覧表示する コンソールで表示するログファイル フィールドの横にある 追加ボタン をクリックします。

  3. 表示される ログファイルエイリアスの編集 ダイアログで、ログエントリのリストに表示するエイリアス名を入力し、ログファイルの場所を指定します。 このパターンがカバーするすべてのファイルを表示するか、最後のパターンのみを表示するかを選択します。

  4. 新しいログファイルがリストに追加される Node.js 実行 / デバッグ構成​​​ ダイアログに戻るには、 OK をクリックします。 その横にある アクティブ チェックボックスを選択します。 前のコンテンツをスキップするには、 内容のスキップ​​​ チェックボックスを選択します。

  5. オプション:

    • プロセスコンソール​​​ 出力をログファイルに保存できるようにするには、 コンソール出力をファイルに保存する チェックボックスをオンにして、ファイルの場所を指定します。

    • プロセスコンソール​​​ をいつ表示するかを選択します。

Node.js アプリケーションをデバッグする

CLion makes it easier to debug Node.js applications. ブレークポイントを JavaScript または TypeScript コードの中に置くと、 debugger および console.log() ステートメントが不要になります。 コードを調べたり、バグの場所を理解するのに役立つ多くのことができます。 デバッグ ツールウィンドウでは、コールスタックと現在の状態の変数を表示し、エディターで式を評価し、コードをステップ実行できます。

次の 2 つの方法でデバッグセッションを開始できます。

  • Node.js 実行 / デバッグ構成を使用して、アプリケーションとともにデバッガーを開始します。

  • すでに実行中のアプリケーションにデバッガーを接続します。 In this case, your application is already running in the debug mode and CLion attaches to a running process.

    CLion recognizes --inspect, --inspect-brk, and now deprecated --debug flags so you can make any application accessible for debugging.

    実行中のアプリケーションをデバッグするには、 Node.js/Chrome への接続構成を使用します。

コンピューター上の Node.js アプリケーションと一緒にデバッガーを起動する

Start and debug a Node.js Express app
  1. 必要に応じて、コードに ブレークポイントを設定します。

  2. Node.js の実行 / デバッグ構成を作成します。

    ブラウザーでアプリケーションを自動的に開くには、起動前のタスクを設定します。 をクリックして 起動前 領域を展開し、 追加ボタン をクリックして、リストから Web ブラウザーの起動 を選択します。 開いたダイアログで、アプリケーションの開始ページの URL(Express アプリケーションの場合は localhost:3000 など)と使用するブラウザーを指定します。

    起動前のタスク: ブラウザーを開く
  3. ツールバーの 実行 ウィジェットリストから、新しく作成された Node.js 構成を選択し、その横にある the Debug button をクリックします。

    実行 / デバッグ構成で Node.js デバッグセッションを開始する

    デバッグツールウィンドウが開きます。

  4. ブレークポイントを使用してコードの実行をトリガーする手順を実行します。 例: アプリケーションの開始ページからブラウザー内の別のページに移動します。

  5. Switch to CLion, where the controls of the デバッグ tool window are now enabled. Proceed with the debugging session — step through the breakpoints, switch between frames, change values on-the-fly, examine a suspended program, evaluate expressions, and set watches.

nodemon を使用する Node.js アプリケーションをデバッグする

The CLion built-in debugger can automatically reconnect to running Node.js processes. これにより、コードが更新されると Node.js プロセスが自動的に再ロードされる、 nodemon ユーティリティ(英語)を使用する Node.js アプリケーションをデバッグできるようになります。

このようなアプリケーションをデバッグするには、(--inspect または --inspect-brk フラグを使用して) デバッグモードでアプリケーションを開始し、 自動的に再接続する​​​ オプションをオンにした Node.js/Chrome へのアタッチデバッグ構成を使用してアプリケーションに接続する必要があります。

nodemon をインストールする

  • コマンドライン シェルまたは組み込み ターミナルエミュレータ (Alt+F12 )で、 npm install --save-dev nodemon または yarn add nodemon --dev と入力して、nodemon を開発依存関係としてインストールします。

デバッグモードで nodemon を使用してアプリケーションを起動する

  • 次の npm debug スクリプトを作成して実行します。

    "debug": "nodemon --inspect <path_to_the_file_that_starts_your_application>

    詳細は、 スクリプトの実行とデバッグを参照してください。

アプリケーションのデバッグ

  1. 必要に応じて、コードに ブレークポイントを設定します。

  2. 実行中の Node.js アプリケーションのデバッグの説明に従って新しい Node.js/Chrome へのアタッチ​​​ 構成を作成し、 自動的に再接続する チェックボックスを選択します。

    Node.js 実行構成をアタッチしない: 自動的に再接続するチェックボックスを選択する

    通常、構成 9229 のポートを変更する必要はありません。これはデバッガーがリッスンしているデフォルトのポートだからです。 ただし、デバッグモードでアプリを実行したときにログに記録されるメッセージで、使用されているポートを再確認できます。

    nodemon がデバッグモードで実行されている Node.js アプリケーション: ポートを確認する
  3. ツールバーの 実行 ウィジェットリストから、新しく作成された Node.js/Chrome への接続 構成を選択し、その横にある the Debug button をクリックします。 The debugger stops at the breakpoints that you put in your code in CLion.

    これで、コードに変更を加えて Ctrl+S として保存するたびに、nodemon はアプリケーションを自動的に再ロードし、デバッガーは再起動されたプロセスに自動的に再アタッチします。

2026 年 11 月 6 日