运行/调试配置对话框

使用远程调试配置启动调试服务器。有关其他信息,请参阅使用 PyCharm 进行远程调试主题。

物品

描述

姓名

在此字段中,指定当前运行/调试配置的名称。

更新你的脚本

本节包含准备远程调试所需的重要信息。

将 PyCharm 安装中的pydevd-pycharm.egg添加到 Python 路径或执行。

例子:pip install pydevd-pycharm~=191.3490

请参阅使用 PyCharm进行远程调试中的过程描述。

添加以下命令以连接到调试服务器

复制下面的命令行语句,并将其粘贴到您的本地脚本中。

import pydevd_pycharm

pydevd_pycharm.settrace(<host name>, port=<port number>), 在哪里

  • <host name>取自此调试配置的IDE 主机名字段。

  • <port number>是从此调试配置的端口字段中获取的数字,或者,如果尚未指定,则为写入控制台的某个随机数。

请注意,此命令的参数取决于此页面中指定的设置。具有默认设置的命令是:

pydevd_pycharm.settrace('localhost', port=$SERVER_PORT,stdoutToServer=True,stderrToServer=True)

对应于主机名“localhost”,端口号 0,选中复选框Redirect output to consoleSuspend after connect

IDE 主机名

指定运行 IDE 的机器的 IP 地址,通过该地址可以访问远程调试服务器。此主机名将自动替换为命令行。默认情况下,使用localhost

港口

指定端口号,它将自动替换为命令行。如果使用默认的 post 编号 (0),那么 PyCharm 会在每次启动此调试配置时将任意编号替换为命令行;如果您指定任何其他值,它将被永久使用。

路径映射

使用此字段创建本地和远程路径之间的映射。单击浏览按钮浏览按钮会打开“编辑路径映射”对话框,您可以在其中添加新路径映射并删除选定的路径映射。本地路径是项目的绝对路径,例如/Users/jetbrains/PyCharmProjects/MyDeployment远程路径是相对于 SFTP 服务器根路径的,例如/tmp/pycharm_project_923

将输出重定向到控制台

如果选中此复选框,则输出和错误流将被重定向到 PyCharm 控制台,命令行补充stdoutToServer=True, stderrToServer=True

连接后挂起

如果选中此复选框,调试器将在连接到 IDE 后立即挂起,在settrace调用后的下一行。

如果未选中此复选框,则调试器将仅在遇到断点或单击时才会暂停暂停,并且命令行会补充suspend=False

常用设置

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

姓名

为运行/调试配置指定一个名称,以便在编辑或运行配置时快速识别它,例如,从运行弹出窗口Alt+Shift+F10中。

允许并行运行

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

默认情况下,它是禁用的,当您在另一个实例仍在运行时启动此配置时,PyCharm 建议停止正在运行的实例并启动另一个实例。当运行/调试配置消耗大量资源并且没有充分理由运行多个实例时,这很有帮助。

存储为项目文件

使用运行配置设置保存文件以与其他团队成员共享。默认位置是.idea/runConfigurations。但是,如果您不想共享.idea目录,您可以将配置保存到项目中的任何其他目录。

默认情况下,它被禁用,并且 PyCharm 将运行配置设置存储在.idea/workspace.xml中。

工具栏

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

物品

捷径

描述

添加按钮

Alt+Insert

创建运行/调试配置。

删除按钮

Alt+Delete

删除选定的运行/调试配置。请注意,您不能删除默认配置。

复制

Ctrl+D

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

保存配置

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

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

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

要创建文件夹,请选择类别中的配置,单击文件夹,然后指定文件夹名称。如果仅关注一个类别,则会创建一个空文件夹。

然后,要将配置移入文件夹、文件夹之间或移出文件夹,请使用拖动或提升下移按钮。

要删除分组,请选择一个文件夹并单击删除配置

排序配置

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

发射前

在此区域中,您可以指定在开始选定的运行/调试配置之前要执行的任务。任务按照它们在列表中出现的顺序执行。

物品

捷径

描述

添加按钮

Alt+Insert

单击此图标可添加以下可用任务之一:

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

  • 运行另一个配置:选择执行另一个运行/调试配置。在打开的对话框中,选择要运行的配置。

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

  • 运行文件观察器:选择此选项让 PyC​​harm 应用所有当前活动的文件观察器。

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

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

    指定 Node.js 解释器的位置、传递给它的参数以及grunt-cli包的路径。

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

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

    指定 Node.js 解释器的位置、传递给它的参数以及gulp包的路径。

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

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

  • 启动 React Native Bundler:选择此选项以自动运行捆绑器,作为运行或调试会话的一部分。默认情况下,这是通过react-native start.

    如果您的应用程序使用Expo,您需要通过startnpm 任务运行开发服务器。为此,请单击添加,然后在Configure React Native对话框中,选择npm script并从列表中选择start 。

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

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

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

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

  • 运行远程外部工具:添加远程 SSH 外部工具

删除按钮

Alt+Delete

单击此图标可从列表中删除选定的任务。

编辑

Enter

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

方法向上/方法向下

Alt+Up/Alt+Down

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

显示此页面

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

激活工具窗口

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

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

最后修改:2021 年 9 月 14 日