# 配置 JavaScript 调试器

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

> **TL;DR**
> 必需插件  :
>
>
>
> `JavaScript 和 TypeScript` ，  `JavaScript Debugger`  - 插件与 CLion 捆绑，并默认启用。

> **Note:**
> JavaScript 代码的调试仅在 [Google Chrome](http://www.google.com/chrome/)和其他 [Chromium-based browsers](https://www.chromium.org/)中受支持。

CLion 为您的  client-side  JavaScript 代码提供内置调试器。 内置调试器会在您 [启动调试会话](debugging-javascript-in-chrome.html#debugging_js_on_built_in_server)时自动启动。

为了确保调试成功，您只需指定内置 web 服务器端口并接受 CLion 为其他调试器选项建议的默认设置。

## 在开始之前

Procedure:

1. 请确保在设置中启用了  JavaScript 和 TypeScript  捆绑插件。 按 `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 。 有关插件的更多信息，请参阅 [管理插件](managing-plugins.html)。

2. 请确保在设置中启用了  JavaScript Debugger  捆绑插件。 按 `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 调试器 。 有关插件的更多信息，请参阅 [管理插件](managing-plugins.html)。

## 设置内置 web 服务器端口

Procedure:

CLion 具有内置的 Web 服务器，可用于在 Web 浏览器中调试您的应用程序或在 CLion 内置浏览器中预览您的代码。 此服务器始终运行，不需要任何手动配置。 了解更多信息，请参阅 [在内置服务器上运行的应用程序的调试](debugging-javascript-in-chrome.html#debugging_js_on_built_in_server)。

1. 按下 `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)) 打开设置，然后选择  `工具 | Web Browsers 和预览` 。

2. 在   内置服务器   区域，指定内置 web 服务器运行的端口。 默认情况下，此端口设置为默认的 CLion 端口  `63342` ，CLion 通过该端口接受来自服务的连接。 您可以将端口号设置为从 1024 开始的任何其他值。

![内置服务器端口](https://resources.jetbrains.com/help/img/idea/2026.3/js_debugger_built_in_server_port.png)

## 自定义默认调试器配置

### 抑制调用

Procedure:

1. 通过按下 `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)) 打开设置，并导航到  `工具 | Web Browsers 和预览` 。

2. 通过清除   可以接受外部连接   或   允许未签名请求   复选框，分别抑制来自其他计算机或 CLion 外部的对内置服务器文件的调用。

![抑制外部调用](https://resources.jetbrains.com/help/img/idea/2026.3/js_debugger_suppress_external_calls.png)

### 选择删除断点的方式

Procedure:

默认情况下，您可以通过点击鼠标左键切换断点。 要更改此行为：

1. 通过按下 `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)) 打开设置，并导航到  `生成、执行、部署 | 调试器` 。

2. 在   移除断点   区域中，选择适当的选项。

![移除断点](https://resources.jetbrains.com/help/img/idea/2026.3/js_debugger_remove_breakpoints.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))）微调此列表。

Procedure:

1. 打开要用于启动调试会话的运行/调试配置，并切换到   单步调试   选项卡。

2. 要禁止自动   智能单步进入  ，请清除   始终使用智能步入   复选框。

3. 要跳过源映射的  `ignoreList`  字段中的脚本，请选中   忽略源代码映射中指定的已知第三方脚本   复选框。

较早的 Chrome 专用字段名称  `x_google_ignoreList`  已弃用，但在缺少  `ignoreList`  字段时可能仍会被识别。 从 [源映射规范](https://tc39.es/ecma426/#sec-source-map-format) 中了解详情。

4. 要禁止步入自定义脚本，请选中   不步入 URL 与以下模式匹配的脚本   复选框，并展开下方此类脚本的默认列表。 使用  `*` 、  `?` 、  `**`  和  `!` 。

![JavaScript 调试器：跳过脚本](https://resources.jetbrains.com/help/img/idea/2026.3/js_debugger_stepping.png)

#### 模式语法

模式支持以下字符：

* 星号 `*` 匹配零个或多个字符，但斜杠 `/` 除外。 在单个路径部分内使用此字符。

* 问号 `?` 仅匹配一个字符，但斜杠 `/` 除外。

* 双星号 `**` 作为完整段时，匹配零个或多个路径段。 其含义取决于它的位置： * 作为第一部分时，它匹配任意前导符号。 * 作为最后一部分时，它匹配任意尾随符号。 * 位于中间时，它匹配一个或多个部分。 例如， `a/**/b` 匹配 `a/x/b` 和 `a/x/y/b` ，但不匹配 `a/b` 。

* 尾随双星号 `**` 位于最后一段末尾时（本身不是一个完整段，例如 `foo**` ），匹配该段之后的任意后缀。 例如， `foo**` 匹配 `foo` 、 `foobar` 和 `foo/bar` 。

* 以感叹号 `!` 开头的模式会否定给定模式，并修改列表中在它之前添加的模式。 它本身不会添加新的模式。

示例 1
: 在模式列表  `["**/*.ts", "!**/*.test.ts"]`  中，第一个 glob 匹配每个  `.ts`  文件。 第二个模式会修改第一个 glob，以从匹配中排除每个  `.test.ts`  文件。

示例 2
: 传入的 URL 会通过斜杠  `/`  拆分为多个部分。 因此，  `**/node_modules/**`  会按如下方式拆分::
:
:
:
: 1.  双星号  `**`  匹配  `node_modules`  段之前的任意路径。
:
: 2.   `node_modules`  与 URL 中的  `node_modules`  匹配。
:
: 3.  双星号  `**`  匹配任意尾随内容。
:
:
:
: 因此，模式  `**/node_modules/**`  匹配包含  `node_modules`  的任意 URL。
:
:
:
: 请注意，脚本的 URL 会与整个模式进行匹配。 如果移除第二个双星号  `**` ，该模式将匹配以  `node_modules`  结尾的任意 URL，而这样的 URL 很可能为零。

示例 3
: 省略第二个双星号  `**` ，以匹配以特定文件名结尾的任何模式。
:
:
:
: * `**/app.js` 匹配所有以 `app.js` 结尾的 URL。
:
: * 以下模式列表将忽略 `node_modules` 中的所有脚本，但名为 `app.js` 的脚本除外。 ``` **/node_modules/** !**/app.js ```

### 高级选项

Procedure:

* 通过按下 `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)) 打开设置，并导航到  `生成、执行、部署 | 调试器 | 数据视图` 。

启用或禁用 [内联调试](null)，指定何时希望看到带有对象值的工具提示和 [表达式评估结果](null)等。

![JavaScript 调试器：数据视图](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_debugger_data_views.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)) 打开设置，并导航到  `生成、执行、部署 | 调试器 | 数据视图` 。

指定是否希望在对象节点中显示对象属性。 如果是这样，指定属性。 请使用 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 和 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) 来管理属性列表。

![对象节点上显示的属性](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_debugger_object_node.png)

## 使用您偏好的 Chrome 用户数据启动调试会话

您可能会注意到，调试会话是在一个使用自定义 [Chrome 用户数据](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md) 的新窗口中启动的，而不是在您平时使用的用户数据中。 因此，窗口看起来很不寻常，例如您的书签、浏览器历史记录和扩展都消失了，这会完全破坏您的开发体验。 因为 CLion 使用 [Chrome 调试协议](https://nodejs.org/api/debugger.html#debugger_v8_inspector_integration_for_node_js) 并使用  `--remote-debugging-port`  选项运行 Chrome。 但是，如果 Chrome 已经启动，则无法为任何使用相同用户数据目录的新建或现有 Chrome 实例打开调试端口。 因此，CLion 始终在一个使用自定义用户数据目录的新窗口中启动调试会话。

要打开一个外观熟悉的 Chrome 实例，请在 CLion 中配置 Chrome，以使用您的用户数据目录启动。

> **Note:**
> 在这种情况下，在启动调试会话之前，请务必确保 Chrome 尚未使用您的用户数据目录运行。 否则，Chrome 会在现有进程中使用您的用户数据目录打开新标签页，从而导致 CLion 调试器无法连接到应用程序并使调试会话无法启动。

![自定义 Chrome 用户数据](https://resources.jetbrains.com/help/img/idea/2026.3/js_debugger_custom_chrome_user_data.animated.gif)

Procedure: 在 CLion 中配置 Chrome，以使用您偏好的 Chrome 用户数据启动

1. 将您偏好的 [Chrome 用户数据](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md) 保存在计算机上的   与 [Chrome 默认用户数据目录](https://chromium.googlesource.com/chromium/src/+/main/docs/user_data_dir.md#Default-Location) 不同的自定义独立目录   中。

您需要将偏好的用户数据保存在自定义独立目录下，因为从 Chrome 136 开始，默认用户目录不再支持调试。 从 [Chrome 官方网站](https://developer.chrome.com/blog/remote-debugging-port) 了解更多信息。

2. 按下 `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)) 打开设置，然后选择  `工具 | Web Browsers 和预览` 。

3. 要创建新的 Chrome 配置，请点击 ![Add](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)。 列表中出现了一个新项。 在   路径  字段中，指定 Chrome 安装文件夹的路径。

4. 选择新配置并点击   编辑  按钮( ![编辑](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg))。

5. 在   Chrome 设置   对话框中，选择   使用自定义用户数据目录   复选框并指定包含您偏好用户数据的自定义目录路径。

如果您有多个 [用户数据配置文件](https://support.google.com/chrome/answer/2364824)，它们中的每一个都存储在一个单独的子目录中。 如需使用某个配置文件，请在   命令行选项   字段中按以下格式指定：

```BASH
--profile-directory="<profile_to_use>"

```

![指定自定义配置文件子目录](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](debugging-javascript-in-chrome.html#create_js_debug_configuration) 时。

> **Tip:**
> 或者，始终从   浏览器  列表中选择此 Chrome 浏览器配置。

## See also

### 流程

[调试](debugging-code.html)

### 参考

[运行/调试配置：JavaScript 调试](run-debug-configuration-javascript-debug.html) [调试工具窗口](debug-tool-window.html)

