PyCharm 2026.1 Help

运行和调试 Angular 应用程序

在开始之前

  1. 请确保您的计算机上已安装 Node.js

  2. 请确保在设置中启用了 JavaScript and TypeScript 插件。 按 Ctrl+Alt+S 打开设置,然后选择 插件。 点击 已安装 选项卡。 在搜索字段中,键入 JavaScript 和 TypeScript。 有关插件的更多信息,请参见 管理插件

  3. 请按照 Angular 和 AngularJS 以及 JavaScript 调试器设置 | 插件 页面,选项卡 Marketplace 上的说明,安装插件,如 从 JetBrains Marketplace 安装插件 中所述。 插件仅在 PyCharm 专业版中可用。

运行 Angular 应用程序

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

    在开发模式下从 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 运行时和包管理器。

    Command 字段中,从列表中选择 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 应用程序

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

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

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

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

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

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

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

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

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

  2. 创建一个 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 配置中稍后指定

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    新建终端:在浏览器中开始调试 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"
2026年 3月 24日