# Node.js の実行とデバッグ

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> 必須プラグイン  ：
>
>
>
> `JavaScript and TypeScript` ,  `JavaScript Debugger` ,  `Node.js` : プラグインは CLion にバンドルされ、デフォルトで有効になっています。

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.

## 始める前に

Procedure:

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

## 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](#debugLocal).

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

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

![構成の編集を開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_run_config_create.png)

開いた   実行構成の編集   ダイアログで、ツールバーの   追加   ボタン ( ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)) をクリックし、リストから   Node.js   を選択します。 [実行/デバッグ構成: Node.js](run-debug-configuration-node-js.html) ダイアログが開きます。

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

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

別の構成済みローカルインタープリターを選択するか、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして新しいものを構成することもできます。

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

4. オプション:

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

* アプリケーションパラメーター フィールドに、 [process.argv(英語)](http://nodejs.org/docs/latest/api/process.html#process.argv) 配列を介して起動時にアプリケーションに渡される Node.js 固有の引数を指定します。

* ブラウザーでアプリケーションを自動的に開くには、起動前のタスクを設定します。 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.arrowRight.svg) をクリックして 起動前 領域を展開し、 ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、リストから Web ブラウザーの起動 を選択します。 開いたダイアログで、アプリケーションの開始ページの URL（Express アプリケーションの場合は `localhost:3000` など）と使用するブラウザーを指定します。 ![起動前のタスク: ブラウザーを開く](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_run_configuration_open_browser_before_launch_task.png)

Procedure: アプリケーションの実行

* [上で説明したように実行 / デバッグ構成を作成する](#Node.js_run)を選択するか、既存のものを変更してダイアログで   実行   をクリックします。

* あるいは、メインツールバーのリストから新しく作成した実行構成を選択し、 ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

![実行 / デバッグ構成でアプリを起動する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_run_app_with_rc.png)

アプリケーションが起動し、 [実行ツールウィンドウ](run-tool-window.html)が開いてアプリケーションの出力が表示されます。

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

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

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

2. 利用可能なログファイル（存在する場合）を一覧表示する   コンソールで表示するログファイル   フィールドの横にある ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックします。

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](https://nodejs.org/en/docs/guides/debugging-getting-started/) 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](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_debug-local.animated.gif)

Procedure:

1. 必要に応じて、コードに [ブレークポイント](using-breakpoints.html)を設定します。

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

ブラウザーでアプリケーションを自動的に開くには、起動前のタスクを設定します。 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.arrowRight.svg) をクリックして   起動前   領域を展開し、 ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、リストから   Web ブラウザーの起動   を選択します。 開いたダイアログで、アプリケーションの開始ページの URL（Express アプリケーションの場合は  `localhost:3000`  など）と使用するブラウザーを指定します。

![起動前のタスク: ブラウザーを開く](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_run_configuration_open_browser_before_launch_task.png)

> **Tip:**
> If necessary, CLion can generate a  JavaScript Debug  configuration and start it automatically together with the  Node.js  configuration .

3. ツールバーの   実行   ウィジェットリストから、新しく作成された   Node.js   構成を選択し、その横にある ![the Debug button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

![実行 / デバッグ構成で Node.js デバッグセッションを開始する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_debug_app_with_rc.png)

[デバッグツールウィンドウ](debug-tool-window.html)が開きます。

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

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

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

> **Tip:**
> 詳細は、 [スクリプトの実行とデバッグ](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_running_npm_scripts)を参照してください。

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

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

Procedure: nodemon をインストールする

* コマンドライン シェルまたは組み込み   ターミナルエミュレータ  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）で、  `npm install --save-dev nodemon`  または  `yarn add nodemon --dev`  と入力して、nodemon を開発依存関係としてインストールします。

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

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

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

```

詳細は、 [スクリプトの実行とデバッグ](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_running_npm_scripts)を参照してください。

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

1. 必要に応じて、コードに [ブレークポイントを設定](using-breakpoints.html)します。

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

![Node.js 実行構成をアタッチしない: 自動的に再接続するチェックボックスを選択する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_run_config_attach_to_node_reconnect.png)

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

![nodemon がデバッグモードで実行されている Node.js アプリケーション: ポートを確認する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_debug_port_nodemon.png)

3. ツールバーの   実行   ウィジェットリストから、新しく作成された   Node.js/Chrome への接続   構成を選択し、その横にある ![the Debug button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。 The debugger stops at the breakpoints that you put in your code in CLion.

これで、コードに変更を加えて `Ctrl+S` (Windows), `⌘ S` (macOS), `⌘ S` (IntelliJ IDEA Classic (macOS)), `⌘ S` (macOS System Shortcuts), `Ctrl+S` (XWin), `Ctrl+S` (GNOME), `Ctrl+S` (KDE), `Ctrl+X, Ctrl+S` (Emacs), `Ctrl+S` (Sublime Text), `⌘ S` (Sublime Text (macOS)), `⌘ S` (Xcode), `Ctrl+Shift+S` (Visual Studio), `⌘ ⇧ S` (Visual Studio (macOS)), `Ctrl+Shift+S` (ReSharper), `⌘ ⇧ S` (ReSharper (macOS)), `Ctrl+Shift+S` (QtCreator), `⌘ ⇧ S` (QtCreator (macOS)), `Ctrl+S` (NetBeans), `Ctrl+S` (Eclipse), `⌘ S` (Eclipse (macOS)) として保存するたびに、nodemon はアプリケーションを自動的に再ロードし、デバッガーは再起動されたプロセスに自動的に再アタッチします。

## See also

### プロシージャ

[Node.js](developing-node-js-applications.html) [デバッグ](debugging-code.html)

### リファレンス

[実行ツールウィンドウ](run-tool-window.html) [デバッグツールウィンドウ](debug-tool-window.html)

