PyCharm 2026.1 Help

运行和调试 React 应用程序.

运行 React 应用程序

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

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

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

    React 应用程序正在运行

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

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

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

创建 npm 运行/调试配置

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

    打开 编辑配置 对话框

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

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

    Command 字段中,从列表中选择 run ,然后从 脚本 列表中选择要运行的脚本。 通常会使用默认的 start 脚本,但您可以在 package.json 中配置其他脚本,例如在自定义端口上运行应用程序。

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

    要在浏览器中打开应用程序,请按以下方式更新配置:在 浏览器/实时编辑 选项卡中,选择 启动后 复选框,选择用于打开应用程序的浏览器,并指定应用程序将运行的 URL 地址。

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

    浏览器/实时编辑选项卡:选择浏览器

运行应用程序

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

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

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

    React 应用程序正在运行

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

调试 React 应用程序

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

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

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

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

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

您可以在 npm 配置内创建一个 JavaScript 调试 配置,以便同时启动它们,具体请参阅 使用 npm 运行/调试配置运行并调试 React 应用程序

或者,分别创建并启动一个 npm 和一个 JavaScript 调试 运行/调试配置,具体请参阅 使用 JavaScript Debug 运行/调试配置开始调试

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

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

  1. 设置 断点 在您的代码中。

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

    如果您使用 create-react-app 生成了应用程序, PyCharm 已经创建了一个默认名称为 npm startnpm 配置。 该配置可从 运行 小部件以及 运行/调试配置 对话框中使用。

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

    Command 字段中,从列表中选择 run ,然后从 脚本 列表中选择要运行的脚本。 通常会使用默认的 start 脚本,但您可以在 package.json 中配置其他脚本,例如在自定义端口上运行应用程序。

    npm 运行/调试配置
  4. 浏览器/实时编辑 选项卡中,选择 启动后 复选框,从列表中选择 Google Chrome 或其他 基于 Chromium 的浏览器 ,选择 使用 JavaScript 调试器 复选框,然后指定应用程序将运行的 URL。

    npm 配置,浏览器选项卡
  5. 单击 运行

    要重新运行该配置,请在 运行 小部件的列表中选择它,并点击其旁边的 运行

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

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

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

  1. 设置 断点 在您的代码中。

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

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

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

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

    创建 JavaScript 调试配置:指定 URL 地址
  5. 单击 调试

    要重新运行该配置,请在 运行 小部件的列表中选择它,并点击其旁边的 调试

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

从运行工具窗口或内置终端开始调试

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

  1. 设置 断点 在您的代码中。

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

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

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

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

    New Terminal:Start debugging in browser 按钮

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

已知限制

当您在调试会话期间首次打开应用程序时,可能会出现页面加载时执行的代码中的某些断点未被命中的情况。 原因是,为了能在原始源代码中的断点处停止,PyCharm 需要从浏览器获取源映射。 不过,浏览器只有在页面至少完整加载过一次之后,才能传递这些源映射。 作为一种变通方法,请在浏览器中手动重新加载页面。

2026年 3月 24日