RubyMine 2026.3 Help

配置 JavaScript 调试器

RubyMine 为您的 client-side JavaScript 代码提供内置调试器。 内置调试器会在您 启动调试会话时自动启动。

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

开始之前

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

  2. 请确保在设置中启用了捆绑的 JavaScript Debugger 插件。 按 Ctrl+Alt+S 打开设置,然后选择 Plugins。 在搜索字段中,输入 JavaScript 调试器。 有关插件的更多信息,请参阅 管理插件。

设置内置 web 服务器端口

RubyMine 具有内置的 Web 服务器,可用于在 Web 浏览器中调试您的应用程序或在 RubyMine 内置浏览器中预览您的代码。 此服务器始终运行,不需要任何手动配置。 了解更多信息,请参阅 在内置服务器上运行的应用程序的调试。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 工具 | Web Browsers 和预览。

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

    内置服务器端口

自定义默认调试器配置

抑制调用

  1. 按 Ctrl+Alt+S 打开设置并导航到 工具 | Web Browsers 和预览。

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

    抑制外部调用

选择删除断点的方式

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

  1. 按 Ctrl+Alt+S 打开设置并导航到 生成、执行、部署 | 调试器。

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

    移除断点

指定要跳过的脚本

某些脚本(例如,标准 Java 类的方法,如 System )会被 单步进入 跳过,因为通常可能不需要调试它们。 您可以在 构建、执行、部署 | 调试器 | 单步调试 页面的 设置 对话框中(Ctrl+Alt+S )微调此列表。

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

  2. 要抑制自动 智能单步进入 ,请清除 始终使用智能步入 复选框。

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

    较旧的 Chrome 专用字段名称 x_google_ignoreList 已弃用,但在缺少 ignoreList 字段时仍可能被识别。 请参阅 源代码映射规范 了解详情。

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

    JavaScript 调试器:跳过脚本

模式语法

模式中支持以下字符:

  • 星号 * 匹配除斜杠 / 之外的零个或多个字符。 请在单个路径部分内使用此字符。

  • 问号 ? 仅匹配除斜杠 / 之外的一个字符。

  • 作为整个段的双星号 ** 可匹配零个或多个路径段。 其含义取决于所在位置:

    • 作为第一部分时,它匹配任何前导符号。

    • 作为最后一部分时,它匹配任何尾随符号。

    • 位于中间时,它匹配一个或多个部分。 例如, 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

高级选项

  • 按 Ctrl+Alt+S 打开设置并导航到 生成、执行、部署 | 调试器 | 数据视图。

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

    JavaScript 调试器:数据视图
  • 按 Ctrl+Alt+S 打开设置并导航到 生成、执行、部署 | 调试器 | 数据视图 | JavaScript。

    指定是否希望在对象节点中显示对象属性。 如果是这样,指定属性。 请使用 和 来管理属性列表。

    对象节点上显示的属性

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

您可能会注意到,调试会话在一个新窗口中启动,使用的是自定义的 Chrome user data ,而不是您平时使用的那一个。 因此,窗口看起来很不寻常,例如您的书签、浏览器历史记录和扩展都消失了,这会完全破坏您的开发体验。 因为 RubyMine 使用 Chrome 调试协议 并使用 --remote-debugging-port 选项运行 Chrome。 但是,如果 Chrome 已经启动,就无法为使用相同用户数据目录的任何新建或已有 Chrome 实例打开调试端口。 因此,RubyMine 总是在一个带有自定义用户数据目录的新窗口中启动调试会话。

要打开具有熟悉外观的新 Chrome 实例,请在 RubyMine 中配置 Chrome,使之使用您的用户数据目录启动。

自定义 Chrome 用户数据

在 RubyMine 中配置 Chrome 以使用您偏好的 Chrome 用户数据启动

  1. 将您偏好的 Chrome user data 保存在计算机上的一个 不同于 Chrome default user data directory 的独立自定义目录 中。

    您需要将偏好的用户数据保存在一个独立的自定义目录中,因为从 Chrome 136 开始,默认用户目录不再支持调试。 从 Chrome 官方网站 了解更多信息。

  2. 按 Ctrl+Alt+S 打开设置,然后选择 工具 | Web Browsers 和预览。

  3. 要创建新的 Chrome 配置,请点击 Add。 列表中出现了一个新项。 在 Path 字段中,指定 Chrome 安装文件夹的路径。

  4. 选择新配置并点击 编辑 按钮(编辑)。

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

    如果您有多个 用户数据配置文件 ,它们中的每一个都存储在一个单独的子目录中。 如需使用某个配置文件,请在 命令行选项 字段中按以下格式指定:

    --profile-directory="<profile_to_use>"
    指定自定义配置文件子目录
  6. 请按照 Web Browsers中描述的将您的Chrome浏览器配置标记为 default。 请不要忘记从 浏览器 列表中选择必要的浏览器在 创建运行/调试配置 时。

2026年 11月 9日