运行和调试 React 应用程序.
运行 React 应用程序
在 package.json 中的
start脚本旁的装订区域中点击,或在 终端 Alt+F12 中执行
npm run start命令,或在 npm 工具窗口 ( )中双击start任务。
等待应用程序编译完成并且开发服务器已就绪。
运行 工具窗口或 终端 显示您的应用程序正在运行的 URL。 如果您的应用程序是用 create-react-app 生成的,默认 URL 为 http://localhost:3000/ 。 点击此链接以查看应用。

通过运行/调试配置运行 React 应用程序
对于在 PyCharm 新建项目 向导 如上所述中使用 create-vite 创建的应用程序,PyCharm 会生成一个默认名称为 npm start 的 npm 配置。 此配置会运行 react-scripts start 命令,该命令会启动开发服务器,并以开发模式启动您的应用程序。
在其他情况下,您需要手动 创建运行/调试配置 ,并设置主机、端口等实际参数。
创建 npm 运行/调试配置
转到 。 或者,在工具栏的 运行 小部件中选择 编辑配置。

在打开的 编辑配置 对话框中,点击工具栏上的 添加 按钮(
),然后从列表中选择 npm。
在打开的 运行/调试配置:npm 对话框的 配置 选项卡中,指定 package.json 的位置、要使用的 Node.js 运行时和包管理器。
在 Command 字段中,从列表中选择 run ,然后从 脚本 列表中选择要运行的脚本。 通常会使用默认的
start脚本,但您可以在 package.json 中配置其他脚本,例如在自定义端口上运行应用程序。
可选:
要在浏览器中打开应用程序,请按以下方式更新配置:在 浏览器/实时编辑 选项卡中,选择 启动后 复选框,选择用于打开应用程序的浏览器,并指定应用程序将运行的 URL 地址。
如果您要调试该应用,请选择 Google Chrome 或其他 基于 Chromium 的浏览器。

运行应用程序
在工具栏的列表中选择 npm start 运行配置,并点击其旁边的
。

等待应用程序编译完成并且开发服务器已就绪。
运行 工具窗口或 终端 显示您的应用程序正在运行的 URL。 点击此链接以查看应用。

或者,启用 PyCharm 在启动时打开应用程序, 如上所述。
调试 React 应用程序
您可以通过 启动运行/调试配置 或 从运行工具窗口 来开始调试会话,该窗口会显示您的应用程序在开发模式下运行的 URL。
通过运行/调试配置开始调试
要调试您的 React 应用程序,您需要两个运行/调试配置:
一个用于在开发模式下启动应用程序的 npm 配置, 如上所述。
一个用于将调试器附加到在开发模式下运行的应用程序的 JavaScript 调试 配置。
您可以在 npm 配置内创建一个 JavaScript 调试 配置,以便同时启动它们,具体请参阅 使用 npm 运行/调试配置运行并调试 React 应用程序。
或者,分别创建并启动一个 npm 和一个 JavaScript 调试 运行/调试配置,具体请参阅 使用 JavaScript Debug 运行/调试配置开始调试。
使用单个 npm 运行/调试配置运行并调试 React 应用程序
使用单个 npm 运行/调试配置运行并调试 React 应用程序
设置 断点 在您的代码中。
创建一个 npm 配置 如上所述。
如果您使用
create-react-app生成了应用程序, PyCharm 已经创建了一个默认名称为 npm start 的 npm 配置。 该配置可从 运行 小部件以及 运行/调试配置 对话框中使用。
在打开的 运行/调试配置:npm 对话框的 配置 选项卡中,指定 package.json 的位置、要使用的 Node.js 运行时和包管理器。
在 Command 字段中,从列表中选择 run ,然后从 脚本 列表中选择要运行的脚本。 通常会使用默认的
start脚本,但您可以在 package.json 中配置其他脚本,例如在自定义端口上运行应用程序。
在 浏览器/实时编辑 选项卡中,选择 启动后 复选框,从列表中选择 Google Chrome 或其他 基于 Chromium 的浏览器 ,选择 使用 JavaScript 调试器 复选框,然后指定应用程序将运行的 URL。

单击 运行。
要重新运行该配置,请在 运行 小部件的列表中选择它,并点击其旁边的
。
PyCharm 会在开发模式下运行应用程序,并同时启动调试会话。

当第一个断点被触发时,切换到 调试工具窗口 并按常规方式进行: 逐步执行程序、 停止并恢复 程序执行、 在挂起时检查 ,探索调用堆栈和变量、设置监视、评估变量、 查看实际 HTML DOM ,等等。
使用 JavaScript 调试 运行/调试配置开始调试
设置 断点 在您的代码中。
在开发模式下启动应用程序, 如上所述 ,并等待应用程序编译完成并且开发服务器已就绪。
运行 工具窗口或 终端 显示您的应用程序正在运行的 URL。 复制此 URL 以便 在 JavaScript Debug 配置中稍后指定。

创建 JavaScript 调试 配置。 为此,请在主菜单中转到 ,点击
,然后从列表中选择 Javascript 调试。
在打开的 运行/调试配置:JavaScript 调试 对话框中,指定配置的名称以及应用程序在开发模式下运行的 URL 地址。 您可以在 运行 工具窗口或在 终端 中复制此 URL, 如上所述。

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

当第一个断点被触发时,切换到 调试工具窗口 并按常规方式进行: 逐步执行程序、 停止并恢复 程序执行、 在挂起时检查 ,探索调用堆栈和变量、设置监视、评估变量、 查看实际 HTML DOM ,等等。
从运行工具窗口或内置终端开始调试
如果您的应用程序在开发模式下运行在 localhost 上,尤其是如果它是使用 create-react-app 生成的,您可以直接从 运行 工具窗口或内置的 终端 启动调试会话。
设置 断点 在您的代码中。
在开发模式下启动应用程序, 如上所述 ,并等待应用程序编译完成并且开发服务器已就绪。
运行 工具窗口或 终端 显示您的应用程序正在运行的 URL。 按住 Ctrl+Shift 并点击此 URL 链接。 PyCharm 会使用自动生成的类型为 JavaScript Debug 的 配置启动调试会话。

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

当第一个断点被触发时,切换到 调试工具窗口 并按常规方式进行: 逐步执行程序、 停止并恢复 程序执行、 在挂起时检查 ,探索调用堆栈和变量、设置监视、评估变量、 查看实际 HTML DOM ,等等。
已知限制
当您在调试会话期间首次打开应用程序时,可能会出现页面加载时执行的代码中的某些断点未被命中的情况。 原因是,为了能在原始源代码中的断点处停止,PyCharm 需要从浏览器获取源映射。 不过,浏览器只有在页面至少完整加载过一次之后,才能传递这些源映射。 作为一种变通方法,请在浏览器中手动重新加载页面。