PyCharm 2026.1 Help

运行/调试配置:JavaScript 调试

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

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

特定于 JavaScript 调试的配置设置

项目

描述

URL

  • 调试 JavaScript:

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

浏览器

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

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

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

为每次运行创建新的用户数据目录

选中此复选框后,每次调试会话都将使用新的隔离用户数据目录。

本地文件的远程 URL

  • 调试 JavaScript:

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

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

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

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

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

通用设置

当您编辑运行配置(而不是运行配置模板)时,可以指定以下选项:

项目

描述

名称(N)

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

存储为项目文件(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 run/debug configuration settings

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

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

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

  • 断开数据源 :如果您希望在运行/调试配置之前断开与数据源的连接,请选择此选项。

“移除”按钮

Alt+Delete

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

编辑

Enter

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

上移方法

下移方法

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

默认情况下,该复选框处于选中状态,并且当您启动运行/调试配置时,会打开 运行调试 工具窗口。

否则,如果清除此复选框,将隐藏工具窗口。 但是,当配置正在运行时,您可以按 Alt+4Alt+5 自行为其打开相应的工具窗口。

聚焦工具窗口

选中此复选框可在启动运行/调试配置时,自动将焦点移动到 运行调试 工具窗口。

2026年 3月 24日