运行/调试配置:JavaScript 调试
创建: 
使用此对话框创建一个配置,用于调试在内置或外部 Web 服务器上运行的 JavaScript 应用程序和调试 Dart Web 应用程序。
JavaScript 调试特定配置设置
项目 | 描述 |
|---|
URL | 调试 JavaScript: 在此字段中,指定引用要调试 JavaScript 的 HTML 文件的 URL 地址。 对于 本地调试 ,请按照 http://localhost:<built-in server port>/<project root> 的格式输入 URL。 内置服务器端口 (为 1024 或更高)在 Web 浏览器和预览 页的 设置 对话框中被指定。 调试 Dart Web 应用程序: 在此字段中,指定引用要调试的 Dart 代码的 HTML 文件的 URL 地址,格式为: http://localhost:<built-in server port>/<project-name>/<relative path to the HTML file> 。 请确保此 URL 地址中的端口与 内置服务器端口 页面上的 Web 浏览器和预览 端口相同。
|
浏览器 | 从此列表中,选择 Chrome 或 Chrome 系列中的其他浏览器来调试您的应用程序。 对于 Dart 应用程序,Dart 代码将通过 dart2js 或 dartdevc 工具编译成 JavaScript。 当您 运行或调试 Dart 网络应用程序时,该工具将自动调用。 |
确保在加载脚本时检测到断点 | 勾选此复选框以确保页面加载时执行代码中的断点立即被命中。 请注意,这可能会减慢初始页面加载速度。 |
本地文件的远程URL | 调试 JavaScript: PyCharm 仅在您手动创建永久调试配置时显示此区域。 对于自动生成的临时配置,不显示该区域。 在此区域,将本地文件与服务器上其副本的 URL 地址进行映射,以便进行调试。 这些映射只有在项目根目录下的本地文件夹结构与服务器上的文件夹结构不同的情况下才需要。 如果结构相同,PyCharm 本身通过解析服务器上副本的 URL 地址“检索”到本地文件的路径。 调试 Dart Web 应用程序: PyCharm 仅在 URL 字段中指定的端口与 设置 对话框的 Web 浏览器和预览 页面上的内置 Web 服务器端口不同的情况下显示此区域。
|
通用设置
当您编辑运行配置(而不是运行配置模板)时,您可以指定以下选项:
项目 | 描述 |
|---|
名称(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 应用所有当前活动的 文件监视器。 运行远程外部工具 :添加一个 remote SSH external tool。 运行Grunt 任务 :选择此选项来运行 Grunt 任务。 在打开的 Grunt 任务 对话框中,指定定义所需任务的 Gruntfile.js ,选择要执行的任务,并指定传递给 Grunt 工具的参数。 指定 Node.js 解释器的位置、要传递给它的参数,以及 grunt-cli 包的路径。 运行 Gulp 任务 :选择此选项以运行 Gulp task。 在打开的 Gulp 任务 对话框中,指定定义所需任务的 Gulpfile.js ,选择要执行的任务,并指定传递给 Gulp 工具的参数。 指定 Node.js 解释器的位置、传递给解释器的参数以及到 gulp 包的路径。 运行 npm Script :选择此选项来执行一个 npm 脚本。 在 NPM Script 对话框中,指定 npm run/debug configuration settings。 编译TypeScript :选择运行内置的 TypeScript 编译器,从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中,选择或清除此 检查错误 复选框,以配置编译器在检测到错误时的行为: 生成CoffeeScript 源映射 :选择此选项以生成 CoffeeScript 源代码的源映射。 在打开的对话框中,指定您的 CoffeeScript 源文件所在的位置。
|

| Alt+Delete | 点击此图标可将所选任务从列表中移除。 |

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


| Alt+Up Alt+Down | 点击这些图标以在列表中将所选任务上移或下移一行。 任务将按照它们在列表中出现的顺序执行。 |
显示此页面 | | 选择此复选框,以便在实际启动运行/调试配置之前显示运行/调试配置设置。 |
激活工具窗口 | | 默认情况下,此复选框处于选中状态,并且在您启动 run/debug 配置时, Run 或 Debug 工具窗口会打开。 否则,如果复选框未选中,工具窗口将被隐藏。 但是,在配置运行时,您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。 |
最后修改日期: 2025年 9月 26日