IntelliJ IDEA 2025.2 Help

运行并调试 Angular 应用程序

运行 Angular 应用程序

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

    在 development mode 中从 package.json 运行 Angular 应用
  2. 请等待应用程序编译完成并且开发服务器就绪。

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

    运行 Angular CLI 应用:开发服务器已准备就绪

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

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

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

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

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

    打开编辑配置对话框

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

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

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

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

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

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

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

运行应用程序

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

  2. 点击 运行

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

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

    运行 Angular CLI 应用:开发服务器已准备就绪

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

调试 Angular 应用程序

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

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

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

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

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

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

或者,单独启动 npmJavaScript 调试 运行/调试配置,如 使用 JavaScript Debug 运行/调试配置开始调试中所述。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    从运行工具窗口开始调试会话

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

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

    新终端:启动在浏览器中调试 Angular 的按钮

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

针对 Node.js 17+ 的故障排除

如果您使用的是 Node.js 版本 17 或更高版本,在调试过程中,您可能会遇到网络连接问题,这会导致调试器附加或者加载 sourcemaps 时出现问题。

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

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