PhpStorm 2026.1 Help

运行和调试 React 应用程序

运行 React 应用程序

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

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

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

    React 应用正在运行

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

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

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

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

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

    打开编辑配置对话框

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

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

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

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

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

    如果您要调试应用程序,请选择 Google Chrome 或另一个 Chromium-based browser

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

运行应用程序

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

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

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

    React 应用正在运行

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

调试 React 应用程序

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

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

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

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

  • 开发模式下附加调试器到正在运行的应用程序的 JavaScript 调试 配置。

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

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

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

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

  1. 在您的代码中设置 breakpoints

  2. 创建一个 npm 配置 如上所述

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

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

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

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

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

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

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

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

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

  1. 在您的代码中设置 breakpoints

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

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

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

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

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

    要重新运行配置,请从 运行 小部件中的列表中选择,然后点击其旁边的 Debug

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

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

如果您的应用程序正在 localhost 上运行开发模式,特别是如果它是用 create-react-app 生成的,您可以直接从 运行 工具窗口或内置的 终端 启动调试会话。

  1. 在您的代码中设置 breakpoints

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

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

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

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

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

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

已知限制

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

2026年 3月 17日