# Next.js

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/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 应用程序的方法是  `create-next-app`  包，该包使用 [npx](https://www.npmjs.com/package/npx) 为您CLion下载和运行。 因此，您的开发环境已预配置为使用 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 运行时   字段中，指定要使用的 Node.js 运行时。 从列表中选择一个已配置的运行时，或选择   Add   以配置新的运行时。

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.

可选：

若要使用 TypeScript 而非 JavaScript，请选中   使用 TypeScript 模板   复选框。 CLion 将为您的应用生成  `.ts` 文件以及一个  `tsconfig.json` 配置文件。

4. 当您点击   创建   时，CLion 会生成一个  Next.js  特定项目，其中包含所有必需的配置文件并下载所需的依赖项。 CLion 还会创建一个  npm start  和一个  JavaScript Debug  配置，使用默认设置来运行或调试您的应用程序。

> **Tip:**
> 或者，打开内置的   终端   并输入：
>
>
>
> 1.
>
> `npx create-next-app <application-name>` 以创建一个应用程序。
>
>
>
> 2.   `cd <application-name>`  切换到应用程序文件夹。
>
> 3.   `npm start` 以启动 Node.js 服务器。

### 在一个空的 CLion 项目中安装 Next.js

在这种情况下，您将不得不自己配置 构建 pipeline。 从 [Next.js 官方网站](https://nextjs.org/docs/getting-started#manual-setup)了解更多关于将 Next.js 添加到项目中的信息。

Procedure: 创建一个空的 CLion 项目

1. 点击   新项目   屏幕上的   欢迎   或从主菜单中选择  `文件 | 新建 项目` 。 “ [新建 项目 对话框](null)”打开。

2. 在左侧窗格中，选择   空项目  。 在右侧窗格中，指定应用程序文件夹并点击   创建  。

Procedure: 在空项目中安装 Next.js

1. 打开您将使用  Next.js 的空项目。

2. 在命令行 shell 或嵌入式   终端  （ `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. 在打开的对话框中，从列表中选择您的版本控制系统，并指定要从中检出的应用程序源代码的存储库。 如需了解更多信息，请参见 [Check out a project (clone)](manage-projects-hosted-on-github.html#clone-from-GitHub)。

Procedure: 下载依赖项

* 请点击   运行 'npm install'   或   运行 'yarn install'   在弹出窗口中：

![打开应用并下载依赖项](https://resources.jetbrains.com.cn/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)。

* 或者，在编辑器或   项目   工具窗口（ `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))）中打开  `package.json`  的上下文菜单，然后选择   运行 'npm install'   或   运行 'yarn install'  。

### 项目安全性

当您打开一个在 CLion 之外创建并导入到 CLion 的项目时，CLion 会显示一个对话框，您可以在其中决定如何处理这个具有不熟悉源代码的项目。

请选择以下选项之一：

* 安全模式中预览 ：在这种情况下，CLion 以预览模式打开项目。 这意味着您可以浏览项目的源代码，但不能运行任务和脚本或运行/调试您的项目。 CLion 会在编辑器区域顶部显示一条通知，您可以随时点击 信任项目… 链接并加载您的项目。

* 信任项目 ：在这种情况下，CLion 会打开并加载一个项目。 这意味着项目已经初始化，项目的插件已解析，依赖项已添加，并且所有 CLion 功能都可用。

* 请勿打开 ：在这种情况下，CLion 不会打开项目。

请从 [项目安全性](project-security.html) 了解更多。

> **Tip:**
> 从欢迎屏幕或通过  `文件 | 新建 | 项目`  创建的项目（如描述中所述）会自动被视为受信任。

## 运行 Next.js 应用程序

要运行您的应用程序，您需要将  `next dev`  命令作为脚本启动，然后点击   运行   工具窗口中的应用程序 URL 或在   终端   中。

您可以从  `next dev`  启动  `package.json`  命令作为脚本，在   终端   中，如 [从编辑器中运行应用程序](#ws_next_run_via_script) 所述或 [通过运行/调试配置](#next_run_run_via_rc)。

### 从编辑器中运行应用程序

Procedure:

1. 在  `package.json`  中  `dev`  脚本旁边的边距点击 ![运行图标](https://resources.jetbrains.com.cn/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`  命令，或双击  `dev`  任务在 [npm 工具窗口](npm-tool-window.html) (  `查看 | 工具窗口 | npm` )。

![从 package.json 运行 next dev](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_next_run_script.png)

2. 等待应用程序编译完成并且开发服务器准备就绪。

运行   工具窗口或   终端   显示了应用程序运行的 URL，默认 URL 是  `http://localhost:3000` 。

![运行工具窗口，带有指向应用程序的链接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_next_run_script_run_tw_link.png)

点击此链接以在浏览器中打开应用程序。

### 通过运行/调试配置运行应用程序

当您打开一个在根目录  `package.json`  中列为依赖项的  `next`  软件包的单仓库项目时，CLion 会自动生成一个类型为 [npm](run-debug-configuration-npm.html) 的  Next.js: server-side  运行/调试配置。 该配置执行  `next dev`  命令，启动开发服务器并以开发模式运行您的应用程序。

> **Note:**
> * 对于单一存储库项目，您需要手动创建此运行/调试配置。
>
> * 对于通过 [新建项目向导](#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.cn/help/img/idea/2026.3/ws_next_run_dev_mode.png)

点击 ![运行图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.run.svg)。

2. 当应用程序编译完成并且开发服务器准备就绪时，   运行   工具窗口或   终端   显示了应用程序运行的 URL。 默认 URL 是  `http://localhost:3000` ，但如果默认端口  `3000`  已被占用，服务器会尝试在最近的空闲端口上启动。

![运行工具窗口，带有指向应用程序的链接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_next_run_script_run_tw_link.png)

点击此链接以在浏览器中打开应用程序。

## 调试 Next.js 应用程序的客户端

使用 CLion，您可以通过两种方式开始调试会话：

* [从编辑器](#ws_next_run_and_debug_via_script) - 以脚本形式从 `package.json` 或在 终端 中运行 `next dev` 命令。 然后通过点击 运行 工具窗口或 终端 中的应用程序 URL 开始调试会话。

* [使用运行/调试配置](#next_running_and_debugging_run_via_rc)。

### 从编辑器开始调试

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

Procedure: 使用 next dev 运行一个应用程序

1. 在  `package.json`  中  `dev`  脚本旁边的边距点击 ![运行图标](https://resources.jetbrains.com.cn/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`  命令，或双击  `dev`  任务在 [npm 工具窗口](npm-tool-window.html) (  `查看 | 工具窗口 | npm` )。

![从 package.json 运行 next dev](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_next_run_script.png)

2. 等待应用程序编译完成并且开发服务器准备就绪。

运行   工具窗口或   终端   显示了应用程序运行的 URL，默认 URL 是  `http://localhost:3000` 。

![运行工具窗口，带有指向应用程序的链接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_next_run_script_run_tw_link.png)

点击此链接以在浏览器中打开应用程序。

Procedure: 从运行工具窗口或终端开始调试会话

1. [设置断点](using-breakpoints.html#set-breakpoints) 在必要的地方。

2. 在  `package.json`  中  `dev`  脚本旁边的边距点击 ![运行图标](https://resources.jetbrains.com.cn/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`  命令，或双击  `dev`  任务在 [npm 工具窗口](npm-tool-window.html) (  `查看 | 工具窗口 | npm` )。

3. 当应用程序编译完成并且开发服务器准备就绪时，   运行   工具窗口或   终端   显示了应用程序运行的 URL。 默认 URL 是  `http://localhost:3000` ，但如果默认端口  `3000`  已被占用，服务器会尝试在最近的空闲端口上启动。

![从运行工具窗口开始调试会话](https://resources.jetbrains.com.cn/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. 当应用程序在浏览器中打开时，执行触发程序运行的操作，例如点击链接。 焦点切换到 CLion，并打开 [调试工具窗口](debug-tool-window.html)。

![调试会话已启动](https://resources.jetbrains.com.cn/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.cn/help/img/idea/2026.3/sourceMapDisable.png)。

### 通过运行/调试配置开始调试

当您打开一个在根目录  `package.json`  中列为依赖项的  `next`  包的单一存储库项目时，CLion 会自动生成两个运行/调试配置：

* Next.js：服务器端 ，类型为 [npm](run-debug-configuration-npm.html)。 该配置执行 `next dev` 命令，启动开发服务器并以开发模式运行您的应用程序。

* Next.js：调试客户端 ，类型为 [JavaScript Debug](run-debug-configuration-javascript-debug.html)，用于在浏览器中调试您的应用程序。

![生成了两个运行/调试配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_next_run_and_debug_two_rc_generated.png)

> **Note:**
> * 对于单一存储库项目，您需要手动创建这些运行/调试配置。
>
> * 对于通过 [新建项目向导](#creating_next_js_app_with_create_next_app) 生成的项目，运行/调试配置会在重新打开项目时生成。
>
> * 如果您删除了自动生成的运行/调试配置，它不会自动重新创建。

Procedure: 创建运行/调试配置

1. 转到  `运行 | 编辑配置` 。 或者，从工具栏的   运行   小部件中选择   编辑配置  。

![打开“Edit Configurations”对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/next_run_config_create.png)

在打开的   编辑配置   对话框中，点击工具栏上的   Add   按钮（ ![添加按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)），然后从列表中选择   npm  。

2. 在打开的   配置   对话框的   运行/调试 配置：npm   选项卡中，指定  `package.json` 、Node.js 运行时以及要使用的包管理器的位置。

在   命令   字段中，从列表中选择   run  ，然后从   脚本   列表中选择要运行的脚本。 很可能它将是默认的  `dev` 脚本，但您可以在您的  `package.json` 中配置另一个脚本，例如，在自定义端口上运行应用程序。

![npm 运行/调试配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/next_debug_npm_rc.png)

3. 可选：

要在浏览器中打开应用程序，请按照以下步骤更新配置：在   Browser / Live Edit   选项卡中，选中   启动后   复选框，选择要在其中打开应用程序的浏览器，并指定应用程序将运行的 URL 地址。

![Browser / Live Edit 选项卡：选择浏览器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/next_run_rc_browser_tab_select_browser.png)

> **Note:**
> 如果您要调试应用程序，请选择 [Google Chrome](http://www.google.com/chrome/) 或另一个 [Chromium-based browser](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.cn/help/img/idea/2026.3/ws_next_run_dev_mode.png)

点击 ![运行图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.run.svg)。

2. 当应用程序编译完成并且开发服务器准备就绪时，   运行   工具窗口或   终端   显示了应用程序运行的 URL。 默认 URL 是  `http://localhost:3000` ，但如果默认端口  `3000`  已被占用，服务器会尝试在最近的空闲端口上启动。

![运行 Next.js 应用程序的开发模式：开发服务器已准备好](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_next_run_with_rc_run_tw.png)

点击此链接查看应用程序。

或者，启用 CLion 以在启动时打开应用程序 [如上所述](#ws_next_start_app_in_dev_mode_enable_opening_browser)。

> **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.cn/help/img/idea/2026.3/next_debug_with_rc.png)

点击 ![调试图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.debug.svg)。

5. 当应用程序在浏览器中打开时，执行触发程序运行的操作，例如点击链接。 焦点切换到 CLion，并打开 [调试工具窗口](debug-tool-window.html)。

按常规操作： [逐步执行程序](stepping-through-the-program.html)、 [停止并恢复](null)程序执行、 [在暂停时检查程序](examining-suspended-program.html)，探索调用堆栈和变量，设置监视，评估变量， [查看实际的 HTML DOM](viewing-actual-html-dom.html) 等。

要忽略源代码映射并逐步执行实际运行的代码，请在   调试   工具窗口的工具栏上按 ![禁用源代码映射切换按钮](https://resources.jetbrains.com.cn/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.cn/help/img/idea/2026.3/ws_next_debug_server.mp4)

当您打开一个在根目录  `package.json`  中列为依赖项的  `next`  软件包的单仓库项目时，CLion 会自动生成一个类型为 [npm](run-debug-configuration-npm.html) 的  Next.js: server-side  运行/调试配置。 该配置执行  `next dev`  命令，启动开发服务器并以开发模式运行您的应用程序。

> **Note:**
> * 对于单一存储库项目，您需要手动创建此运行/调试配置。
>
> * 对于通过 [新建项目向导](#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.cn/help/img/idea/2026.3/ws_next_debug_server_side_start_app_in_dev_mode_rc.png)

点击 ![调试图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.debug.svg)。

3. 执行触发程序执行的操作，例如点击一个链接。 焦点切换到 CLion，并打开 [调试工具窗口](debug-tool-window.html)。

按常规操作： [逐步执行程序](stepping-through-the-program.html)、 [停止并恢复](null)程序执行、 [在暂停时检查程序](examining-suspended-program.html)，探索调用堆栈和变量，设置监视，评估变量， [查看实际的 HTML DOM](viewing-actual-html-dom.html) 等。

要忽略源代码映射并逐步执行实际运行的代码，请在   调试   工具窗口的工具栏上按 ![禁用源代码映射切换按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sourceMapDisable.png)。

