# Next.js

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

CLion は [Next.js](https://nextjs.org/) React フレームワークと統合されています。

## 始める前に

Procedure:

1. お使いのコンピューターに [Node.js(英語)](http://nodejs.org/) がインストールされていることを確認してください。

2. JavaScript と TypeScript  および  Next.js  に必要なプラグインが、   設定 | プラグイン  ページで有効化されていることを確認してください。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

## 新しい Next.js アプリケーションを作成する

新しい Next.js アプリケーションの構築を開始する推奨方法は、 [npx](https://www.npmjs.com/package/npx) を使って CLion がダウンロードして実行する  `create-next-app`  パッケージです。 その結果、開発環境は Next.js を使用するように事前構成されています。

もちろん、ご自身で  `create-next-app`  をダウンロードしたり、空の CLion プロジェクトを作成して Next.js をインストールすることもできます。

> **Tip:**
> [Next.js 公式サイト(英語)](https://nextjs.org/docs/getting-started)から Next.js を開始する方法について詳しくは、こちらを参照してください。

### create-next-app で Next.js アプリケーションを生成する

Procedure:

1. ようこそ   画面で   新規プロジェクト   をクリックするか、メインメニューから  `ファイル | 新規 プロジェクト`  を選択します。 [新規 プロジェクト ダイアログ](null)が開きます。

2. 左側のペインで、   Next.js   を選択します。

3. 右側のペイン：

1.

プロジェクト関連ファイルが保存されるフォルダーへのパスを指定します。

2.

ノードランタイム   フィールドで使用する Node.js ランタイムを指定します。 リストから設定済みのランタイムを選択するか、   追加   を選択して新しいランタイムを設定してください。

3.

create-next-app   リストから   npx create-next-app   を選択してください。

または、npm バージョン 5.1 以前の場合、   ターミナルエミュレータ   `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 next react react-dom`  を実行して、  `create-next-app`  パッケージを自分でインストールします。 アプリケーションを作成するときに、  `create-next-app`  パッケージが保存されているフォルダーを選択します。

4.

オプション:

JavaScript の代わりに TypeScript を使用するには、   TypeScript テンプレートの使用   チェックボックスを選択します。 CLion はアプリケーション用の  `.ts`  ファイルと  `tsconfig.json`  構成ファイルを生成する。

4. 作成   をクリックすると、CLion は必要な構成ファイルがすべて含まれる  Next.js  専用プロジェクトを生成し、必要な依存関係をダウンロードする。 また、CLion はアプリケーションの実行またはデバッグ用のデフォルト設定を持つ  npm start  と  JavaScript デバッグ 構成も作成します。

> **Tip:**
> または、組み込みの   ターミナルエミュレータ   を開いて、次のように入力します。
>
>
>
> 1.
>
> `npx create-next-app <application-name>`  を使用してアプリケーションを作成します。
>
>
>
> 2.   `cd <application-name>`  を押してアプリケーションフォルダーに切り替えます。
>
> 3.   `npm start`  を実行して Node.js サーバーを起動します。

### 空の CLion プロジェクトに Next.js をインストールする

この場合、ビルドパイプラインを自分で構成する必要があります。 [Next.js 公式サイト(英語)](https://nextjs.org/docs/getting-started#manual-setup)からプロジェクトに Next.js を追加する方法については、こちらを参照してください。

Procedure: 空の CLion プロジェクトを作成する

1. ようこそ   画面で   新規プロジェクト   をクリックするか、メインメニューから  `ファイル | 新規 プロジェクト`  を選択します。 [新規 プロジェクト ダイアログ](null)が開きます。

2. 左側のペインで、   空のプロジェクト   を選択します。 右側のウィンドウで、アプリケーションフォルダーを指定し、   作成   をクリックします。

Procedure: 空のプロジェクトに Next.js をインストールする

1. Next.js  を使用する空のプロジェクトを開きます。

2. コマンドライン シェルまたは組み込みの   ターミナルエミュレータ  （ `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 next react react-dom`

## 既存の Next.js アプリケーションから開始する

既存の Next.js アプリケーションの開発を続けるには、それを CLion で開いて必要な依存関係をダウンロードします。

Procedure: すでにマシン上にあるアプリケーションソースを開く

* ようこそ   画面で   オープン   をクリックするか、メインメニューから  `ファイル | オープン`  を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。

Procedure: バージョン管理からアプリケーションのソースをチェックアウト

1. ようこそ   画面で   リポジトリのクローン   をクリックします。

あるいは、メインメニューから  `ファイル | 新規 | バージョン管理からプロジェクト…`  、  `Git | クローン…`  、  `VCS | バージョン管理から取得`  を選択します。

メインメニューの   Git   の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例:   Mercurial   または   Perforce  。

2. 表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 [プロジェクトのチェックアウト (クローン)](manage-projects-hosted-on-github.html#clone-from-GitHub) を参照してください。

Procedure: 依存関係をダウンロードする

* ポップアップで   'npm install' の実行   または   'yarn install' の実行   をクリックします。

![アプリケーションを開いて依存関係をダウンロードする](https://resources.jetbrains.com/help/img/idea/2026.3/ws_npm_yarn_package_run_npm_install_next_js.png)

[npm](https://docs.npmjs.com/)、 [Yarn 1](https://classic.yarnpkg.com/lang/en/)、または [Yarn 2](https://yarnpkg.com/) を使用できます。詳細は [npm と Yarn](installing-and-removing-external-software-using-node-package-manager.html) をご確認ください。

* または、エディターの  `パッケージ.json​​`  のコンテキストメニュー、または   プロジェクト   ツールウィンドウ ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) ) で   'npm install' の実行   または   'yarn install' の実行   を選択します。

### プロジェクトのセキュリティ

CLion の外部で作成され、そこにインポートされたプロジェクトを開くと、CLion は、未知のソースコードを含むこのプロジェクトの処理方法を選択できるダイアログを表示します。

次のいずれかのオプションを選択します：

* セーフモードでプレビュー : この場合、CLion はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。 CLion はエディター領域の上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックすることで、いつでもプロジェクトをロードできます。

* プロジェクトを信頼 : この場合、CLion はプロジェクトを開いてロードします。 これは、プロジェクトが初期化され、プラグインが解決され、依存関係が追加され、すべての CLion 機能が利用可能になることを意味します。

* 開かない : この場合、CLion はプロジェクトを開きません。

詳細については、 [プロジェクトのセキュリティ](project-security.html) を参照してください。

> **Tip:**
> ようこそ画面や  `ファイル｜新規｜プロジェクト`  で作成されたプロジェクトは、自動的に信頼済みと見なされます。

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

アプリケーションを実行するには、  `next dev`  コマンドをスクリプトとして起動し、   実行   ツールウィンドウまたは   ターミナルエミュレータ   でアプリケーション URL をクリックする必要があります。

[エディターからアプリケーションを実行する](#ws_next_run_via_script)または [実行 / デバッグ構成経由](#next_run_run_via_rc)に従って、   ターミナルエミュレータ   内の  `パッケージ.json​​`  からスクリプトとして  `next dev`  コマンドを起動できます。

### エディターからアプリケーションを実行する

Procedure:

1. `パッケージ.json​​`  の  `dev`  スクリプトの横にあるガターで ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリック、あるいは   ターミナルエミュレータ   `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)) で  `next dev`  コマンドを実行、または [npm ツールウィンドウ](npm-tool-window.html)（  `表示 | ツール Windows | npm` ）で  `dev`  タスクを double-click してください。

![package.json から next dev を実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_script.png)

2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまでお待ちください。

実行   ツールウィンドウまたは   ターミナルエミュレータ   に、アプリケーションが実行されている URL が表示され、デフォルトの URL は  `http://localhost:3000`  です。

![アプリへのリンクを含むツールウィンドウを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_script_run_tw_link.png)

このリンクをクリックすると、ブラウザーでアプリケーションが開きます。

### 実行 / デバッグ構成でアプリケーションを実行する

ルート  `パッケージ.json​​`  に依存関係として  `next`  パッケージが記載されている単一リポジトリプロジェクトを開くと、CLion は [npm](run-debug-configuration-npm.html) タイプの  Next.js: server-side  実行 / デバッグ構成を自動的に生成する。 この構成は、開発サーバーを起動し、アプリケーションを開発モードで実行する  `next dev`  コマンドを実行します。

> **Note:**
> * mono-repo プロジェクトの場合、この実行 / デバッグ構成を手動で作成する必要があります。
>
> * [新規プロジェクトウィザード](#creating_next_js_app_with_create_next_app)を介して生成されたプロジェクトの場合、プロジェクトを再度開くと実行 / デバッグ構成が生成されます。
>
> * 自動生成された実行 / デバッグ構成を削除しても、自動的には新規に作成されません。

Procedure:

1. ツールバーの   実行   ウィジェットのリストから、   npm   タイプの実行構成を選択します。 これは、自動生成された   Next.js: サーバーサイド   構成、または [以下で説明するよう](#next_running_and_debugging_run_via_rc_create_rc)に自分で作成したカスタム構成のいずれかになります。

![実行 / デバッグ構成を使用して開発モードで Next.js アプリを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_dev_mode.png)

![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリックします。

2. アプリケーションがコンパイルされ、開発サーバーの準備が完了すると、   実行   ツールウィンドウまたは   ターミナルエミュレータ   に、アプリケーションが実行されている URL が表示されます。 デフォルトの URL は  `http://localhost:3000`  ですが、デフォルトポート  `3000`  がすでに使用中の場合、サーバーは最も近い空きポートで起動を試みます。

![アプリへのリンクを含むツールウィンドウを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_script_run_tw_link.png)

リンクをクリックすると、ブラウザーでアプリケーションが開きます。

## Next.js アプリケーションのクライアント側をデバッグする

CLion では、デバッグセッションを次の２つの方法で開始できます：

* [エディターから](#ws_next_run_and_debug_via_script) - `パッケージ.json​​` または ターミナルエミュレータ から `next dev` コマンドをスクリプトとして実行します。 その後、 実行 ツールウィンドウまたは ターミナルエミュレータ でアプリケーション URL をクリックしてデバッグセッションを開始します。

* [実行 / デバッグ構成の使用](#next_running_and_debugging_run_via_rc)。

### エディターからデバッグを開始する

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_and_debug.mp4)

Procedure: Next Dev でアプリケーションを実行する

1. `パッケージ.json​​`  の  `dev`  スクリプトの横にあるガターで ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリック、あるいは   ターミナルエミュレータ   `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)) で  `next dev`  コマンドを実行、または [npm ツールウィンドウ](npm-tool-window.html)（  `表示 | ツール Windows | npm` ）で  `dev`  タスクを double-click してください。

![package.json から next dev を実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_script.png)

2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまでお待ちください。

実行   ツールウィンドウまたは   ターミナルエミュレータ   に、アプリケーションが実行されている URL が表示され、デフォルトの URL は  `http://localhost:3000`  です。

![アプリへのリンクを含むツールウィンドウを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_script_run_tw_link.png)

このリンクをクリックすると、ブラウザーでアプリケーションが開きます。

Procedure: 実行ツールウィンドウまたはターミナルからデバッグセッションを開始する

1. 必要に応じて [ブレークポイントの設定](using-breakpoints.html#set-breakpoints)。

2. `パッケージ.json​​`  の  `dev`  スクリプトの横にあるガターで ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリック、あるいは   ターミナルエミュレータ   `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)) で  `next dev`  コマンドを実行、または [npm ツールウィンドウ](npm-tool-window.html)（  `表示 | ツール Windows | npm` ）で  `dev`  タスクを double-click してください。

3. アプリケーションがコンパイルされ、開発サーバーの準備が完了すると、   実行   ツールウィンドウまたは   ターミナルエミュレータ   に、アプリケーションが実行されている URL が表示されます。 デフォルトの URL は  `http://localhost:3000`  ですが、デフォルトポート  `3000`  がすでに使用中の場合、サーバーは最も近い空きポートで起動を試みます。

![実行ツールウィンドウからデバッグセッションを開始する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_debug_from_run_tw.png)

`Ctrl+Shift` (Windows), `Ctrl+Shift` (macOS), `Ctrl+Shift` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift` (macOS System Shortcuts), `Ctrl+Shift` (XWin), `Ctrl+Shift` (GNOME), `Ctrl+Shift` (KDE), `Ctrl+Shift` (Emacs), `Ctrl+Shift` (Sublime Text), `Ctrl+Shift` (Sublime Text (macOS)), `Ctrl+Shift` (Xcode), `Ctrl+Shift` (Visual Studio), `Ctrl+Shift` (Visual Studio (macOS)), `Ctrl+Shift` (ReSharper), `Ctrl+Shift` (ReSharper (macOS)), `Ctrl+Shift` (QtCreator), `Ctrl+Shift` (QtCreator (macOS)), `Ctrl+Shift` (NetBeans), `Ctrl+Shift` (Eclipse), `Ctrl+Shift` (Eclipse (macOS)) を押しながらリンクをクリックします。

4. アプリケーションがブラウザーで開いたら、プログラムの実行をトリガーするアクション（たとえば、リンクをクリックするなど）を実行します。 フォーカスは [デバッグツールウィンドウ](debug-tool-window.html) が開いた状態で CLion に切り替わります。

![デバッグセッションが開始されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_debug_from_run_tw_debug_session.png)

通常どおり操作を続けてください： [プログラムをステップ実行](stepping-through-the-program.html)、 [停止・再開](null)、 [中断時に調査](examining-suspended-program.html)、コールスタックや変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM の表示](viewing-actual-html-dom.html)などが行えます。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

### 実行 / デバッグ構成でデバッグを開始する

ルート  `パッケージ.json​​`  に依存関係として  `next`  パッケージが記載されている単一リポジトリプロジェクトを開くと、CLion は２つの実行 / デバッグ構成を自動的に生成する：

* [npm](run-debug-configuration-npm.html) タイプの Next.js: server-side 。 この構成は、開発サーバーを起動し、アプリケーションを開発モードで実行する `next dev` コマンドを実行します。

* ブラウザーでアプリケーションをデバッグするには、タイプ [JavaScript デバッグ](run-debug-configuration-javascript-debug.html)の Next.js: クライアント側のデバッグ を使用します。

![2 つの実行 / デバッグ構成が生成されます](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_and_debug_two_rc_generated.png)

> **Note:**
> * mono-repo プロジェクトの場合、これらの実行 / デバッグ構成を手動で作成する必要があります。
>
> * [新規プロジェクトウィザード](#creating_next_js_app_with_create_next_app)を介して生成されたプロジェクトの場合、プロジェクトを再度開くと実行 / デバッグ構成が生成されます。
>
> * 自動生成された実行 / デバッグ構成を削除しても、自動的には新規に作成されません。

Procedure: 実行 / デバッグ構成の作成

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

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

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

2. 開いた   実行 / デバッグ構成: npm   ダイアログの   構成   タブで、  `パッケージ.json​​`  の場所、Node.js ランタイム、および使用するパッケージマネージャーを指定します。

コマンド   フィールドで、リストから   run   を選択し、次に   スクリプト   リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの  `dev`  スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、  `パッケージ.json​​`  で別のスクリプトを構成することもできます。

![npm 実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/next_debug_npm_rc.png)

3. オプション:

ブラウザーでアプリケーションを開くには、構成を次のように更新します：   ブラウザー / Live Edit  タブで、   起動後  チェックボックスをオンにし、アプリケーションを開くブラウザーを選択して、アプリケーションが実行される URL アドレスを指定します。

![ブラウザー / ライブ編集タブ: ブラウザーを選択](https://resources.jetbrains.com/help/img/idea/2026.3/next_run_rc_browser_tab_select_browser.png)

> **Note:**
> アプリケーションをデバッグする場合は、 [Google Chrome(英語)](http://www.google.com/chrome/) または別の [Chromium ベースのブラウザー(英語)](https://www.chromium.org/)を選択します。

Procedure: npm 実行 / デバッグ構成を使用して開発モードでアプリケーションを実行する

1. ツールバーの   実行   ウィジェットのリストから、   npm   タイプの実行構成を選択します。 これは、自動生成された   Next.js: サーバーサイド   構成、または [前述のよう](#next_running_and_debugging_run_via_rc_create_rc)に自分で作成したカスタム構成のいずれかになります。

![実行 / デバッグ構成を使用して開発モードで Next.js アプリを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_dev_mode.png)

![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリックします。

2. アプリケーションがコンパイルされ、開発サーバーの準備が完了すると、   実行   ツールウィンドウまたは   ターミナルエミュレータ   に、アプリケーションが実行されている URL が表示されます。 デフォルトの URL は  `http://localhost:3000`  ですが、デフォルトポート  `3000`  がすでに使用中の場合、サーバーは最も近い空きポートで起動を試みます。

![開発モードで Next.js アプリを実行する: 開発サーバーの準備ができました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_run_with_rc_run_tw.png)

このリンクをクリックすると、アプリケーションが表示されます。

あるいは、 [上記](#ws_next_start_app_in_dev_mode_enable_opening_browser)のように CLion で起動時にアプリケーションを開くよう有効化することもできます。

> **Note:**
> 開発サーバーが実行中は、ソースファイルを変更して更新を保存すると、アプリケーションは自動的に再読み込みされます。

Procedure: JavaScript デバッグ構成でデバッグを開始する

1. 必要に応じて [ブレークポイントの設定](using-breakpoints.html#set-breakpoints)。

2. アプリケーションを開発モード [npm 実行 / デバッグ構成](#next_running_and_debugging_run_via_rc_steps)または [next dev

と](#ws_next_run_and_debug_via_script)で実行します。

3. アプリケーションがコンパイルされ、開発サーバーの準備が完了すると、   実行   ツールウィンドウまたは   ターミナルエミュレータ   に、アプリケーションが実行されている URL が表示されます。 デフォルトの URL は  `http://localhost:3000`  ですが、デフォルトポート  `3000`  がすでに使用中の場合、サーバーは最も近い空きポートで起動を試みます。

> **Note:**
> JavaScript デバッグ​   構成で実際のポートを指定してください。

4. ツールバーの   実行   ウィジェットのリストから、   JavaScript デバッグ​   タイプの実行構成を選択します。 これは、自動生成された   Next.js: デバッグクライアント   構成、または [前述のよう](#next_running_and_debugging_run_via_rc_create_rc)に自分で作成したカスタム構成のいずれかになります。

![デバッグセッションを開始する - JavaScript デバッグ実行構成を選択する](https://resources.jetbrains.com/help/img/idea/2026.3/next_debug_with_rc.png)

![デバッグアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.debug.svg) をクリックします。

5. アプリケーションがブラウザーで開いたら、プログラムの実行をトリガーするアクション（たとえば、リンクをクリックするなど）を実行します。 フォーカスは [デバッグツールウィンドウ](debug-tool-window.html) が開いた状態で CLion に切り替わります。

通常どおり操作を続けてください： [プログラムをステップ実行](stepping-through-the-program.html)、 [停止・再開](null)、 [中断時に調査](examining-suspended-program.html)、コールスタックや変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM の表示](viewing-actual-html-dom.html)などが行えます。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

[React アプリケーションの実行](run-and-debug-react-applications.html#react_running_and_debugging_run) および [React アプリケーションのデバッグ](run-and-debug-react-applications.html#react_running_and_debugging_debug) をご参照ください。

## Next.js アプリケーションのサーバー側コンポーネントをデバッグする

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_debug_server.mp4)

ルート  `パッケージ.json​​`  に依存関係として  `next`  パッケージが記載されている単一リポジトリプロジェクトを開くと、CLion は [npm](run-debug-configuration-npm.html) タイプの  Next.js: server-side  実行 / デバッグ構成を自動的に生成する。 この構成は、開発サーバーを起動し、アプリケーションを開発モードで実行する  `next dev`  コマンドを実行します。

> **Note:**
> * mono-repo プロジェクトの場合、この実行 / デバッグ構成を手動で作成する必要があります。
>
> * [新規プロジェクトウィザード](#creating_next_js_app_with_create_next_app)を介して生成されたプロジェクトの場合、プロジェクトを再度開くと実行 / デバッグ構成が生成されます。
>
> * 自動生成された実行 / デバッグ構成を削除しても、自動的には新規に作成されません。

Procedure:

1. サーバー側コード内の必要な場所にブレークポイントを設定します。

2. ツールバーの   実行   ウィジェットのリストから、   npm   タイプの実行構成を選択します。 これは、自動生成された   Next.js: サーバーサイド   構成、または [前述のよう](#next_running_and_debugging_run_via_rc_create_rc)に自分で作成したカスタム構成のいずれかになります。

![実行 / デバッグ構成を使用して、Next.js アプリのサーバー側コードのデバッグを開始する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_next_debug_server_side_start_app_in_dev_mode_rc.png)

![デバッグアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.debug.svg) をクリックします。

3. プログラムの実行をトリガーするアクションを実行してください。たとえば、リンクをクリックします。 フォーカスは [デバッグツールウィンドウ](debug-tool-window.html) が開いた状態で CLion に切り替わります。

通常どおり操作を続けてください： [プログラムをステップ実行](stepping-through-the-program.html)、 [停止・再開](null)、 [中断時に調査](examining-suspended-program.html)、コールスタックや変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM の表示](viewing-actual-html-dom.html)などが行えます。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

