WebStorm 2025.2 Help

配置 JavaScript 调试器

WebStorm 提供内置调试器,用于调试您的 客户端 JavaScript 代码。 当您 启动调试会话 时,内置调试器会自动启动。

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

开始之前

  • 请确保在设置中启用了 JavaScript Debugger 捆绑插件。 按 Ctrl+Alt+S 打开设置,然后选择 插件。 点击 已安装 选项卡。 在搜索字段中输入 JavaScript Debugger。 如需了解有关插件的更多信息,请参阅 管理插件

设置内置 Web 服务器端口

WebStorm 拥有一个内置 Web 服务器,您可以使用它在 Web 浏览器中调试应用程序,或在 WebStorm 的内置浏览器中预览代码。 此服务器始终处于运行状态,无需任何手动配置。 详细了解,请参阅 调试在内置服务器上运行的应用程序

  1. Ctrl+Alt+S 打开设置,然后导航到 工具 | Web 浏览器与预览

  2. 内置服务器 区域中,指定内置 Web 服务器运行的端口。 默认情况下,该端口设置为默认的 WebStorm 端口 63342 ,WebStorm 通过它接受来自服务的连接。 您可以将端口号设置为任意大于等于 1024 的值。

    内置服务器端口

自定义默认调试器配置

抑制调用

  1. 按下 Ctrl+Alt+S 打开设置,然后导航至 构建、执行、部署 | 调试器

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

    抑制外部调用

选择断点删除方式

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

  1. 按下 Ctrl+Alt+S 打开设置,然后导航至 构建、执行、部署 | 调试器

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

    删除断点

指定要跳过的脚本

默认情况下,调试器只是不进入库脚本。 如需扩展跳过列表:

  1. 按下 Ctrl+Alt+S 打开设置,然后导航至 构建、执行、部署 | 调试器 | 步进

  2. 选中 不要进入脚本 复选框,使用 添加按钮删除按钮 添加要跳过的 URL 地址。

    JavaScript 调试器:跳过脚本

高级选项

  • 按下 Ctrl+Alt+S 打开设置,然后导航至 构建、执行、部署 | 调试器 | 数据视图

    启用或禁用 内联调试 、指定何时显示对象值和 表达式求值结果 的工具提示等。

    JavaScript 调试器:数据视图
  • 按下 Ctrl+Alt+S 打开设置,并导航至 构建、执行、部署 | 调试器 | 数据视图

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

    对象节点上显示的属性

使用首选的 Chrome 用户数据启动调试会话

您可能会注意到调试会话是在一个带有自定义 Chrome 用户数据 的新窗口中启动的,而不是使用您平常的用户数据。 因此,该窗口可能看起来与众不同,例如缺少书签、浏览器历史记录和扩展程序,从而会影响您的开发体验。 这种情况是由于 WebStorm 使用了 Chrome Debugging Protocol 并通过 --remote-debugging-port 选项运行 Chrome。 但是,如果 Chrome 已经启动,则无法为使用相同用户数据目录的新建或现有 Chrome 实例打开调试端口。 因此,WebStorm 始终在新窗口中以自定义用户数据目录启动调试会话。

如需使用熟悉的外观打开新的 Chrome 实例,请在 WebStorm 中配置 Chrome 以您自己的用户数据目录启动。

自定义 Chrome 用户数据

在 WebStorm 中配置 Chrome 以使用首选的 Chrome 用户数据启动

  1. 将首选的 Chrome 用户数据 保存在计算机上的 自定义目录中,该目录应不同于 Chrome 默认用户数据目录

    您需要将首选的用户数据保存在单独的自定义目录中,因为 Chrome 136 及更高版本不支持在默认用户目录中进行调试。 请参阅 Chrome 官方网站 了解更多信息。

  2. Ctrl+Alt+S 打开设置,然后选择 工具 | Web 浏览器与预览

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

  4. 选择新的配置,然后点击 编辑 按钮(编辑)。

  5. Chrome 设置 对话框中,选中 使用自定义用户数据目录(U) 复选框,并指定包含首选用户数据的自定义目录路径。

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

    --profile-directory="<profile_to_use>"
    指定自定义配置文件子目录
  6. 按照 选择默认 WebStorm 浏览器 中的说明,将您的 Chrome 浏览器配置标记为 默认。 创建 运行/调试配置 时,请勿忘记从 浏览器 列表中选择所需的浏览器。

最后修改日期: 2025年 9月 26日