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

IntelliJ IDEA 2026.3 Help

运行并调试 React 应用程序

运行 React 应用程序

  1. 点击 运行图标 (位于 start 脚本旁的装订区域,该脚本在 package.json 中),或者执行 npm run start 命令(在 终端 Alt+F12 中),或者双击 start 任务(在 npm 工具窗口 (查看 | 工具窗口 | npm )中)。

    从 package.json 中以开发模式运行 React 应用
  2. 等待应用程序编译完成且开发服务器就绪。

    运行 工具窗口或 终端 会显示应用程序正在运行的 URL。 如果您的应用是使用 create-react-app 生成的,那么默认的 URL 是 http://localhost:3000/ 。 点击此链接查看应用程序。

    React 应用正在运行

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

对于使用 create-vite 在IntelliJ IDEA 新建项目 向导中 如上所述创建的应用程序,IntelliJ IDEA会生成一个默认名称为 npm start 的 npm配置。 此配置会运行 react-scripts start 命令,该命令将启动开发服务器并以开发模式启动应用程序。

在其他情况下,您需要手动 创建一个运行/调试配置 ,并设置实际的参数,如主机、端口等。

创建一个 npm 运行/调试配置

  1. 前往 运行 | 编辑配置。 或者,在工具栏上的 运行 小部件中选择 编辑配置。

    打开编辑配置对话框

    在打开的 编辑配置 对话框中,点击工具栏上的 添加 按钮("添加"按钮 ),然后从列表中选择 npm。

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

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

    npm 运行/调试配置
  3. 可选:

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

    如果要调试应用程序,请选择 Google Chrome 或其他 基于 Chromium 的浏览器。

    Browser / Live Edit 选项卡:选择浏览器

运行应用程序

  1. 从工具栏上的列表中选择 npm start 运行配置,然后点击其旁边的 运行。

    通过运行/调试配置在开发模式下运行 React 应用程序
  2. 等待应用程序编译完成且开发服务器就绪。

    运行 工具窗口或 终端 会显示应用程序正在运行的 URL。 点击此链接查看应用程序。

    React 应用正在运行

    或者,启用 IntelliJ IDEA 以在启动时打开应用程序 如上所述。

调试 React 应用程序

您可以通过 启动运行/调试配置或 从运行工具窗口 ,该窗口显示您的应用程序在开发模式下运行的 URL,开始调试会话。

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

要调试 React 应用程序,需要两个运行/调试配置:

  • 在开发模式下启动应用程序的 npm 配置, 如上所述。

  • 用于将调试器附加到以开发模式运行的应用程序的 JavaScript Debug 配置。

您可以在 JavaScript Debug 配置中创建一个 npm 配置,以便一次启动它们,如 使用 npm 运行/调试配置运行和调试 React 应用程序中所述。

或者,分别创建并启动 npm 和 JavaScript Debug 运行/调试配置,如 使用 JavaScript Debug 运行/调试配置开始调试 中所述。

使用单个 npm run/debug 配置运行和调试 React 应用程序

使用单个 npm run/debug 配置运行和调试 React 应用程序

  1. 在代码中设置 断点。

  2. 创建 npm 配置, 如上所述。

    如果您使用 create-react-app 生成了应用程序,IntelliJ IDEA 已经使用默认名称 npm start 创建了一个 npm 配置。 此配置可通过 运行 小部件或 运行/调试配置 对话框获得。

    自动生成的 npm run/debug 配置
  3. 在打开的 配置 对话框的 运行/调试配置:npm 选项卡中,指定 package.json 、Node.js 运行时以及要使用的包管理器的位置。

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

    npm 运行/调试配置
  4. 在 浏览器 / Live Edit 选项卡中,选中 在启动后 复选框,从列表中选择 Google Chrome 或其他 Chromium-based browser ,选中 使用 JavaScript 调试器 复选框,然后指定您的应用程序将运行的 URL。

    npm 配置,浏览器标签
  5. 点击 运行。

    要重新运行该配置,请从 运行 微件中的列表中选择它,然后点击其旁边的 运行。

    IntelliJ IDEA 在开发模式下运行应用程序,同时启动调试会话。

    调试会话
  6. 当第一个断点被触发时,切换到 调试工具窗口 并按常规方式继续: 逐步执行程序, 停止并恢复程序执行, 在挂起时检查程序 ,探索调用堆栈和变量,设置监视,评估变量, 查看实际的 HTML DOM ,等等。

    要忽略源代码映射并逐步执行实际运行的代码,请在 调试 工具窗口的工具栏上点击 禁用源代码映射切换按钮​。

使用 JavaScript Debug 运行/调试配置开始调试

  1. 在代码中设置 断点。

  2. 启动应用程序的开发模式 ,如上所述 ,并等待应用程序编译完成以及开发服务器就绪。

    运行 工具窗口或 终端 会显示应用程序正在运行的 URL。 请复制此 URL 到 稍后在 JavaScript Debug 配置中指定。

    应用程序正在以开发模式运行
  3. 创建一个 JavaScript Debug 配置。 要执行此操作,请在主菜单中转到 运行 | 编辑配置 ,点击 "添加"图标 ,然后从列表中选择 JavaScript 调试。

  4. 在打开的 运行/调试配置:JavaScript Debug 对话框中,指定配置的名称以及应用程序在开发模式下运行的 URL 地址。 您可以在 运行 工具窗口或 终端 中复制此 URL, 如上所述。

    创建一个 JavaScript 调试配置:指定 URL
  5. 点击 调试。

    要重新运行该配置,请从 运行 微件中的列表中选择它,然后点击其旁边的 调试。

    从运行小部件运行 JavaScript Debug 配置
  6. 当第一个断点被触发时,切换到 调试工具窗口 并按常规方式继续: 逐步执行程序, 停止并恢复程序执行, 在挂起时检查程序 ,探索调用堆栈和变量,设置监视,评估变量, 查看实际的 HTML DOM ,等等。

    要忽略源代码映射并逐步执行实际运行的代码,请在 调试 工具窗口的工具栏上点击 禁用源代码映射切换按钮​。

从 Run 工具窗口或内置 Terminal 开始调试

如果应用程序在 本地主机 上以开发模式运行,尤其是使用 create-react-app 生成的应用程序,可以直接从 运行 工具窗口或内置 终端 启动调试会话。

  1. 在代码中设置 断点。

  2. 启动应用程序的开发模式 ,如上所述 ,并等待应用程序编译完成以及开发服务器就绪。

  3. 运行 工具窗口或 终端 会显示应用程序正在运行的 URL。 按住 Ctrl+Shift 并点击此 URL 链接。 IntelliJ IDEA 将使用自动生成的 配置启动调试会话,该配置的类型为 JavaScript Debug。

    从运行工具窗口开始调试 React 应用

    如果从 新终端 以开发模式启动了应用程序,只需点击链接旁边的 在浏览器中启动调试 按钮即可。

    新终端:在浏览器中开始调试按钮

    默认情况下,不显示该按钮。 要显示该按钮,请打开 设置 对话框(Ctrl+Alt+S ),转到 高级设置 ,然后在 JavaScript 和 TypeScript 区域选择 在终端中为本地主机链接显示“在浏览器中开始调试”按钮 复选框。

当第一个断点被触发时,切换到 调试工具窗口 并按常规方式继续: 逐步执行程序, 停止并恢复程序执行, 在挂起时检查程序 ,探索调用堆栈和变量,设置监视,评估变量, 查看实际的 HTML DOM ,等等。

要忽略源代码映射并逐步执行实际运行的代码,请在 调试 工具窗口的工具栏上点击 禁用源代码映射切换按钮​。

已知限制

当您在调试会话期间第一次打开应用程序时,可能会发生代码在页面加载时执行的一些断点未被触发。 原因是若要在原始源代码中停在断点处,IntelliJ IDEA 需要从浏览器中获取 source maps。 然而,浏览器只能在页面至少完全加载一次后才能传递这些 source maps。 作为一种解决方法,您可以自己在浏览器中重新加载该页面。

2026年 11月 3日