# 运行和调试 Angular 应用程序

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

## 在开始之前

Procedure:

1. 请确保您的计算机上安装了 [Node.js](http://nodejs.org/)。

2. 确保  JavaScript 和 TypeScript 、  Angular 和 AngularJS  和  JavaScript 调试器  所需插件已在   设置 | 插件   页面上启用。 如需了解更多信息，请参阅 [管理插件](managing-plugins.html)。

## 运行 Angular 应用程序

Procedure:

1. 在  `package.json`  中  `start`  脚本旁边的边距点击 ![运行图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg)，或在   终端   `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)) 中执行  `npm run start`  命令，或双击  `start`  任务在 [npm 工具窗口](npm-tool-window.html) (  `查看 | 工具窗口 | npm` )。

![在 development mode 中从 package.json 运行 Angular 应用](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_run_dev_mode_package_json.animated.gif)

2. 等待应用程序编译完成并且开发服务器准备就绪。

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

![正在运行 Angular CLI 应用：开发服务器已就绪](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_run_dev_server_ready.png)

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

对于使用 Angular CLI 在 CLion   新项目   向导中创建的应用程序 [如上所述](angular.html#create_new_angular_app)，CLion 会生成一个 [npm](run-debug-configuration-npm.html) 配置，默认名称为   Angular CLI Server  。 此配置运行  `ng serve` 命令，该命令启动开发服务器并以开发模式启动您的应用程序。

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

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

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

![打开“Edit Configurations”对话框](https://resources.jetbrains.com/help/img/idea/2026.3/angular_run_config_create.png)

在打开的   编辑配置   对话框中，点击工具栏上的   Add   按钮（ ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)），然后从列表中选择   npm  。

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

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

![npm 运行/调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/angular_debug_npm_rc.png)

3. 可选：

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

如果您要调试应用程序，请选择 [Google Chrome](http://www.google.com/chrome/) 或另一个 [Chromium-based browser](https://www.chromium.org/)。

![Browser / Live Edit 选项卡：选择浏览器](https://resources.jetbrains.com/help/img/idea/2026.3/angular_run_rc_browser_tab_select_browser.png)

Procedure: 运行应用程序

1. 从工具栏上的   运行   小部件列表中，选择一种   npm   类型的运行配置。 这可以是自动生成的   Angular CLI Server  配置，或者是您自行创建的自定义配置 [如上所述](#angular_running_and_debugging_run_via_rc_create_rc)。

2. 点击 ![运行](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg)。

![通过运行/调试配置以开发模式运行 Angular 应用程序](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_run_dev_mode.png)

3. 等待应用程序编译完成并且开发服务器准备就绪。

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

![正在运行 Angular CLI 应用：开发服务器已就绪](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_run_dev_server_ready.png)

或者，启用 CLion 以在启动时打开应用程序 [如上所述](#ws_angular_start_app_in_dev_mode_enable_opening_browser)。

> **Note:**
> 当开发服务器正在运行时，您的应用程序会在您更改任意源文件并保存更新后自动重新加载。

## 调试 Angular 应用程序

> **Note:**
> Angular 应用的调试仅在 [Google Chrome](http://www.google.com/chrome/) 和其它 [基于 Chromium 的浏览器](https://www.chromium.org/) 中受支持。

您可以通过 [启动运行/调试配置](#angular_debug_with_rc)或 [从运行工具窗口](#angular_debug_from_tw)，该窗口显示您的应用程序在开发模式下运行的 URL，开始调试会话。

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

要调试 Angular 应用程序，需要两个运行/调试配置：

* 在开发模式下启动应用程序的 npm 配置， [如上所述](#angular_running_and_debugging_run)。

* 开发模式下附加调试器到正在运行的应用程序的 JavaScript 调试 配置。 > **Note:** > 如果您使用 Angular CLI 生成了应用程序， [如上所述](angular.html#create_new_angular_app)，CLion 已经生成了这两个运行/调试配置。

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

或者，分别启动   npm   和   JavaScript 调试   运行/调试配置，如 [使用 JavaScript Debug 运行/调试配置开始调试](#angular_debug_via_js_debug_rc)中所述。

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

1. 在您的代码中设置 [breakpoints](using-breakpoints.html)。

2. 创建一个   npm  配置 [如上所述](#angular_running_and_debugging_run_via_rc_create_rc)。

> **Note:**
> 如果您使用  `Angular CLI`  生成了应用程序，CLion 已经使用默认名称   Angular CLI Server   创建了一个   npm   配置。 此配置可通过   运行  小部件或   运行/调试配置  对话框获得。

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

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

![npm 运行/调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/angular_debug_npm_rc.png)

4. 在   Browser / Live Edit   选项卡中，选中   启动后   复选框，从列表中选择 [Google Chrome](http://www.google.com/chrome/) 或其他 [Chromium-based browser](https://www.chromium.org/)，选中   使用 JavaScript 调试器   复选框，然后指定您的应用程序将运行的 URL。

![Browser / Live Edit 选项卡：选择浏览器](https://resources.jetbrains.com/help/img/idea/2026.3/angular_run_rc_browser_tab_select_browser.png)

5. 点击   运行  。

要重新运行配置，请从   运行  小部件中的列表中选择，然后点击其旁边的 ![运行](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg)。

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

![调试会话](https://resources.jetbrains.com/help/img/idea/2026.3/angular_debug_npm_rc_debugging_session.png)

6. 当第一个断点被命中时，切换到 [调试工具窗口](debug-tool-window.html)并像往常一样继续： [逐步执行程序](stepping-through-the-program.html)， [停止和恢复](null)程序执行， [在暂停时检查程序](examining-suspended-program.html)，探索调用堆栈和变量，设置监视，评估变量， [查看实际的 HTML DOM](viewing-actual-html-dom.html)，等等。

要忽略源代码映射并逐步执行实际运行的代码，请在   调试   工具窗口的工具栏上按 ![禁用源代码映射切换按钮](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png)。

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

1. 在您的代码中设置 [breakpoints](using-breakpoints.html)。

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

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

![Angular 应用正在开发模式中运行](https://resources.jetbrains.com/help/img/idea/2026.3/angular_run_app_url.png)

3. 创建一个   JavaScript 调试  配置。 要执行此操作，请在主菜单中转到  `运行 | 编辑配置` ，点击 !["添加"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从列表中选择   JavaScript 调试  。

如果使用 Angular CLI 生成了应用程序， [如上所述](angular.html#create_new_angular_app)，CLion 已经创建了一个   JavaScript 调试   运行/调试配置，默认名称为   调试应用程序  ，默认 URL 为  `http://localhost:4200` 。 从   JavaScript 调试   节点下的列表中选择此 run/debug 配置。

![选择生成的 JavaScript 调试运行/调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/angular_debug_select_js_debug_rc.png)

4. 在打开的   运行/调试配置：JavaScript Debug  对话框中，指定配置的名称以及应用程序在开发模式下运行的 URL 地址。 您可以在   运行   工具窗口或   终端   中复制此 URL， [如上所述](#angular_debug_dev_mode_URL)。

![创建一个 JavaScript 调试配置：指定 URL](https://resources.jetbrains.com/help/img/idea/2026.3/angular_debug_create_js_debug_rc.png)

> **Note:**
> 如果您正在使用自动生成的配置，请确保指定的网址是您的应用程序实际运行的地址。

5. 点击   调试  。

要重新运行配置，请从   运行  小部件中的列表中选择，然后点击其旁边的 ![调试](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg)。

![从运行小部件运行 JavaScript Debug 配置](https://resources.jetbrains.com/help/img/idea/2026.3/angular_debug_rerun_js_debug_rc.png)

6. 当第一个断点被命中时，切换到 [调试工具窗口](debug-tool-window.html)并像往常一样继续： [逐步执行程序](stepping-through-the-program.html)， [停止和恢复](null)程序执行， [在暂停时检查程序](examining-suspended-program.html)，探索调用堆栈和变量，设置监视，评估变量， [查看实际的 HTML DOM](viewing-actual-html-dom.html)，等等。

要忽略源代码映射并逐步执行实际运行的代码，请在   调试   工具窗口的工具栏上按 ![禁用源代码映射切换按钮](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png)。

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

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

Procedure:

1. 在您的代码中设置 [breakpoints](using-breakpoints.html)。

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

3. 运行   工具窗口或   终端   显示您的应用程序正在运行的 URL。 如果应用程序是使用 @angular/cli 生成的，则默认 URL 为  `http://localhost:4200/` 。 请按住 `Ctrl+Shift` (Windows), `Ctrl+Shift` (macOS), `Ctrl+Shift` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift` (macOS System Shortcuts), `Ctrl+Shift` (XWin), `Ctrl+Shift` (GNOME), `Ctrl+Shift` (KDE), `Ctrl+Shift` (Emacs), `Ctrl+Shift` (Sublime Text), `Ctrl+Shift` (Sublime Text (macOS)), `Ctrl+Shift` (Xcode), `Ctrl+Shift` (Visual Studio), `Ctrl+Shift` (Visual Studio (macOS)), `Ctrl+Shift` (ReSharper), `Ctrl+Shift` (ReSharper (macOS)), `Ctrl+Shift` (QtCreator), `Ctrl+Shift` (QtCreator (macOS)), `Ctrl+Shift` (NetBeans), `Ctrl+Shift` (Eclipse), `Ctrl+Shift` (Eclipse (macOS)) 并点击此 URL 链接。 CLion 启动了一个调试会话，使用了自动生成的   Angular 应用   类型为 [JavaScript Debug](run-debug-configuration-javascript-debug.html) 的配置。

![从运行工具窗口开始调试会话](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_start_debug_from_run_tw.animated.gif)

或者，从列表中选择自动生成的   Angular 应用  配置，然后点击列表旁边的   调试  按钮 ![调试按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg)。

如果您从 [New Terminal](terminal-emulator.html) 以开发模式启动了应用程序，您只需点击链接旁边的   在浏览器中开始调试   按钮即可。

![新终端：启动在浏览器中调试 Angular 的按钮](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_start_debugging_from_new_terminal_start_debugging_button.png)

默认情况下，不显示该按钮。 要显示它，请打开   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `高级设置` ，并在   JavaScript 和 TypeScript   区域选中   在终端中为本地主机链接显示“在浏览器中开始调试”按钮   复选框。

> **Note:**
> 该按钮在 WSL 的   新终端  中不可用。

当第一个断点被触发时，切换到 [调试工具窗口](debug-tool-window.html) 并像往常一样继续： [逐步执行程序](stepping-through-the-program.html)、 [停止和恢复](null)程序执行、 [在暂停时检查](examining-suspended-program.html)、探索调用堆栈和变量、设置监视、评估变量、 [查看实际的 HTML DOM](viewing-actual-html-dom.html) 等。

要忽略源代码映射并逐步执行实际运行的代码，请在   调试   工具窗口的工具栏上按 ![禁用源代码映射切换按钮](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png)。

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

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

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

```JSON
"start": "ng serve --host=127.0.0.1"

```

