PyCharm 2025.2 Help

运行/调试配置：Python 调试服务器

使用远程调试配置启动调试服务器。 欲了解更多信息，请参阅 使用 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> 是从此调试配置的 端口 字段中获取的数字，或者，如果未指定，则为写入控制台的某个随机数字。

IDE 主机名

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

端口

指定端口号，该端口号将自动替换到命令行中。 如果使用默认端口号（0），则 PyCharm 在每次启动此调试配置时会将一个任意数字替换到命令行中；如果您指定了其他值，则会永久使用该值。

路径映射

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

将输出重定向到控制台

如果选中此复选框，输出和错误流将被重定向到 PyCharm 控制台，并且命令行将补充 stdout_to_server=True, stderr_to_server=True。

连接后挂起

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

如果未选中此复选框，调试器仅在遇到断点或点击 挂起 时挂起，并且命令行将补充 suspend=False。

通用设置

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

项目

描述

名称(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 脚本 ：选择此选项来执行一个 npm 脚本。

    在 NPM Script 对话框中，指定 npm run/debug configuration settings。

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

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

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

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

"移除"按钮

Alt+Delete

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

编辑

Enter

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

方法向上

方法 down

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。

否则，如果复选框未选中，工具窗口将被隐藏。 但是，在配置运行时，您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。

最后修改日期： 2025年 9月 26日
运行/调试配置：Python运行/调试配置：Python 文档