llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

运行并调试 Angular 应用程序

开始之前

  1. 下载并安装 Node.js。

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

  3. 安装 Angular 和 AngularJS 以及 JavaScript 调试器 插件(在 设置 | 插件 页面上),如 从 JetBrains Marketplace 安装插件中所述。”}]}નલ? Wait final has invalid smart quote ending? I accidentally put ” before }. Need fix. Also final with response format? Must valid JSON. Do again. Need ensure no extra commentary. final only JSON.幸运飞艇. Wait final in typed processData includes JSON, but invalid. Need final corrected. Can I produce new? Yes final. Ensure no markdown. Use full-width Chinese punctuation. No issue. Need no pluralForm. Need exact tags. Final.} I see final content has weird trailing 插件仅在具有 Ultimate 订阅的 IntelliJ IDEA 中可用。

运行 Angular 应用程序

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

    在 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 运行时以及要使用的包管理器的位置。

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

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

    要在浏览器中打开应用程序,请按照以下步骤更新配置:在 浏览器 / Live Edit 选项卡中,选中 在启动后 复选框,选择要在其中打开应用程序的浏览器,并指定应用程序将运行的 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 Debug 配置。

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

或者,分别启动 npm 和 JavaScript Debug 运行/调试配置,如 使用 JavaScript Debug 运行/调试配置开始调试 中所述。

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

  1. 在代码中设置 断点。

  2. 创建 npm 配置, 如上所述。

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

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

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

    Browser / Live Edit 选项卡:选择浏览器
  5. 点击 运行。

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

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

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

    要忽略源代码映射并逐步执行实际运行的代码,请在 调试 工具窗口的工具栏上点击 禁用源代码映射切换按钮​。

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

  1. 在代码中设置 断点。

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

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

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

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

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

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

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

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

    要忽略源代码映射并逐步执行实际运行的代码,请在 调试 工具窗口的工具栏上点击 禁用源代码映射切换按钮​。

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

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

  1. 在代码中设置 断点。

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

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

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

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

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

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

    默认情况下,不显示该按钮。 要显示该按钮,请打开 设置 对话框(Ctrl+Alt+S ),转到 高级设置 ,然后在 JavaScript 和 TypeScript 区域选择 在终端中为本地主机链接显示“在浏览器中开始调试”按钮 复选框。

当第一个断点被触发时,切换到 调试工具窗口并按常规操作: 逐步执行程序, 停止并恢复程序执行, 在挂起时检查程序 ,探索调用堆栈和变量,设置监视,评估变量, 查看实际的 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"
2026年 11月 3日