PyCharm 2025.3 Help

运行/调试配置：JavaScript 调试

创建： 运行(U) | 编辑配置(E) | 添加新配置| JavaScript 调试

使用此对话框创建用于调试在内置或外部 Web 服务器上运行的应用程序中的 JavaScript，以及调试 Dart Web 应用程序的配置。

特定于 JavaScript 调试的配置设置

项目

描述

URL

  • 调试 JavaScript：

    在此字段中，指定引用要调试的 JavaScript 的 HTML 文件的 URL 地址。 对于 本地调试 ，请按以下格式输入 URL： http://localhost:<内置服务器端口>/<项目根> 。 在 设置 对话框的 Web 浏览器和预览 页面上指定 内置服务器端口 （ 1024 或更高 ）。

  • 调试 Dart Web 应用程序：

    在此字段中，按以下格式指定引用要调试的 Dart 代码的 HTML 文件的 URL 地址： http://localhost:<内置服务器端口>/<项目名称>/<HTML 文件的相对路径> 。 确保此 URL 地址中的端口与 Web 浏览器和预览 页面上的 内置服务器端口 相同。

浏览器

在此列表中，选择 Chrome 或 Chrome 系列中的其他浏览器，用于调试您的应用程序。

对于 Dart 应用程序，Dart 代码将通过 dart2js 或 dartdevc 工具编译为 JavaScript。 当您 运行或调试 Dart Web 应用程序时，将自动调用该工具。

在加载脚本时确保检测到断点

选中此复选框，可确保在页面加载时执行的代码中的断点立即被命中。 请注意，这可能会降低初始页面加载速度。

本地文件的远程 URL

  • 调试 JavaScript：

    仅当您手动创建永久调试配置时，PyCharm 才会显示此区域。 对于自动生成的临时配置，将不显示此区域。

    在此区域中，将参与调试的本地文件映射到其在服务器上的副本的 URL 地址。

    • 文件/目录 - 在此只读字段中，在项目树中选择所需的本地文件或目录。

    • 远程 URL - 在此字段中，输入服务器上相应文件或文件夹的绝对 URL 地址。

    只有当项目根目录下的本地文件夹结构与服务器上的文件夹结构不同，才需要这些映射。 如果结构相同，PyCharm 将通过解析其在服务器上的副本的 URL 地址来 "检索" 本地文件的路径。

  • 调试 Dart Web 应用程序：

    仅当 URL 字段中指定的端口与 设置 对话框的 Web 浏览器和预览 页面上指定的内置 Web 服务器端口不同，PyCharm 才会显示此区域。

通用设置

编辑运行配置（而非运行配置模板）时，您可以指定以下选项：

项目

描述

名称(N)

为运行配置指定名称，以便在编辑或运行时快速识别。

允许多个实例(U)

允许并行运行此运行配置的多个实例。

默认禁用；当在另一个实例仍在运行时启动此配置，PyCharm 会建议停止正在运行的实例并启动另一个。 当某个运行配置占用大量资源且没有必要运行多个实例时，这将很有帮助。

存储为项目文件(S)

将包含运行配置设置的文件保存下来，以便与其他团队成员共享。 默认位置为 .idea/runConfigurations 。 但是，如果您不想共享 .idea 目录，可以将配置保存到项目内的任意其他目录。

默认禁用，PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。

工具栏

运行/调试配置的树形视图带有一个工具栏，可帮助您管理 项目 中可用的配置，并调整默认配置模板。

项目

快捷键

描述

添加按钮

Alt+Insert

创建运行/调试配置。

移除按钮

Alt+Delete

删除所选运行/调试配置。 请注意，无法删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。 请注意，您创建的是默认配置的副本。

保存配置

仅当您选择 临时配置 时，才会显示该按钮。 点击此按钮可将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移动到新文件夹/创建新文件夹。 您可以通过 将它们放入文件夹 对运行/调试配置进行分组。

要创建文件夹，请在某个类别内选择配置，点击 文件夹 ，并指定文件夹名称。 如果仅聚焦于某个类别，则会创建一个空文件夹。

然后，要将配置移动到某个文件夹、在文件夹之间移动或移出文件夹，请使用拖动，或使用 上移 与 下移 按钮。

要移除分组，请选择某个文件夹并点击 移除配置。

排序配置

点击此按钮可按字母顺序对配置进行排序。

启动前

在此区域，您可以指定在启动所选运行/调试配置之前要执行的任务。 任务将按它们在列表中出现的顺序执行。

项目

快捷键

描述

添加按钮

Alt+Insert

点击此图标以添加以下可用任务之一：

  • 启动Web 浏览器 ：选择此选项以启动浏览器。 在打开的对话框中，选择浏览器类型并提供起始 URL。 此外，指定是否使用 JavaScript 调试器启动浏览器。

  • 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择您要运行的一个或多个应用程序。 如果尚未在 PyCharm 中定义，请添加其定义。 有关详细信息，请参阅 外部工具 和 外部工具。

  • 运行另一个配置 ：选择执行另一个运行/调试配置，并在其完成后再启动当前配置。 如果您想并行运行多个配置，请使用 复合运行/调试配置。

  • 运行File Watcher ：选择此选项，PyCharm 将应用当前处于活动状态的所有 文件监视器。

  • 运行远程外部工具 ：添加一个 远程 SSH 外部工具。

  • 运行Grunt 任务 ：选择此选项以运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定要传递给 Grunt 工具的参数。

    指定 Node.js 运行时的位置、传递给它的参数，以及 grunt-cli 软件包的路径。

  • 运行 Gulp 任务 ：选择此选项以运行 Gulp 任务。

    在打开的 Gulp 任务 对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。

    指定 Node.js 运行时的位置、传递给它的参数，以及 gulp 软件包的路径。

  • 运行 npm 脚本 ：选择此选项以执行 npm 脚本。

    在打开的 npm 脚本 对话框中，指定 npm 运行/调试配置设置。

  • 编译TypeScript ：选择运行内置 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选中或清除 检查错误 复选框，以配置在检测到任何错误时编译器的行为：

    • 如果选中 检查错误 复选框，编译器将显示所有错误，且运行配置不会启动。

    • 如果清除 检查错误 复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。

  • 生成CoffeeScript 源映射 ：选择此选项为您的 CoffeeScript 源文件生成源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件的位置。

移除按钮

Alt+Delete

点击此图标可从列表中移除所选任务。

编辑

Enter

点击此图标可编辑所选任务。 在打开的对话框中进行必要的更改。

方法上移

方法下移

Alt+Up

Alt+Down

点击这些图标可将所选任务在列表中上移或下移一行。 任务将按照它们在列表中出现的顺序执行。

显示此页面

选中此复选框可在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认选中此复选框，启动运行/调试配置时将打开 Run 或 Debug 工具窗口。

否则，如果清除了复选框，该工具窗口将隐藏。 但是，在配置运行时，您可以按 Alt+4 或 Alt+5 自行打开其对应的工具窗口。

最后修改日期： 2025年 12月 2日
运行/调试配置： Gulp.js运行/调试配置： Jest