PyCharm 2025.3 Help

运行和调试 Angular 应用程序

运行 Angular 应用程序

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

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

    运行 工具窗口或 终端 显示您的应用程序正在运行的 URL 地址。 如果您的应用程序是使用 @angular/cli 生成的,默认 URL 地址为 http://localhost:4200/ 。 点击此链接以查看应用程序。

    正在运行 Angular CLI 应用程序:开发服务器已就绪

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

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

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

创建 npm 运行/调试配置

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

    打开编辑配置对话框

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

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

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

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

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

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

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

运行应用程序

  1. 从工具栏上的 运行 小部件的列表中,选择一个类型为 npm 的运行配置。 这可以是自动生成的 Angular CLI 服务器 配置,或者是您自行创建的自定义配置 如上所述

  2. 点击 运行

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

    运行 工具窗口或 终端 显示您的应用程序正在运行的 URL 地址。 如果您的应用程序是使用 @angular/cli 生成的,默认 URL 地址为 http://localhost:4200/ 。 点击此链接以查看应用程序。

    正在运行 Angular CLI 应用程序:开发服务器已就绪

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

调试 Angular 应用程序

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

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

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

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

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

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

或者,分别启动一个 npm 和一个 JavaScript 调试 运行/调试配置,如 通过 JavaScript 调试 运行/调试配置开始调试 中所述。

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

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

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

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

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

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

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

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

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

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

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

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

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

    运行 工具窗口或 终端 显示您的应用程序正在运行的 URL 地址。 复制此 URL, 稍后在 JavaScript 调试配置中指定它

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

    如果您使用 Angular CLI 生成了应用程序, 如上所述 ,PyCharm 已经创建了一个 JavaScript 调试 运行/调试配置,默认名称为 调试应用程序 ,默认 URL 地址为 http://localhost:4200。 从 JavaScript 调试 节点下的列表中选择该运行/调试配置。

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

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

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

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

从 Run 工具窗口或内置终端中开始调试

如果您的应用程序在开发模式下运行在 localhost ,尤其是在使用 Angular CLI 生成的情况下,您可以直接从 >运行 工具窗口或内置 终端 中启动调试会话。

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

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

  3. 运行 工具窗口或 终端 显示您的应用程序正在运行的 URL 地址。 如果您的应用程序是使用 @angular/cli 生成的,默认 URL 地址为 http://localhost:4200/ 。 按住 Ctrl+Shift 并点击此 URL 链接。 PyCharm 使用自动生成的 Angular 应用程序 配置(类型为 JavaScript 调试 )启动调试会话。

    从 Run 工具窗口开始调试会话

    或者,从列表中选择自动生成的 Angular 应用程序 配置,然后点击列表旁边的 调试 按钮 调试按钮

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

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

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

针对 Node.js 17+ 的疑难解答

如果您使用 Node.js 版本 17 或更高版本,在调试会话期间,您可能会遇到网络连接问题,从而导致附加调试器或加载源映射出现问题。

解决方法是通过如下方式更新您在 package.json 中的 start 脚本,将 --host 127.0.0.1 传递给服务器:

"start": "ng serve --host=127.0.0.1"
最后修改日期: 2025年 12月 2日