Python 调试服务器

创建：运行(U)｜编辑配置(E)｜ | Python 调试服务器

使用远程调试配置启动调试服务器。有关更多信息，请参见使用 PyCharm 进行远程调试。

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

项目	快捷方式	描述
	`Alt+Insert`	创建运行/调试配置。
	`Alt+Delete`	删除选定的运行/调试配置。请注意，您无法删除默认配置。
	`Ctrl+D`	创建所选运行/调试配置的副本。请注意，您将创建默认配置的副本。
		仅当您选择了临时配置时，才会显示该按钮。点击此按钮以将临时配置保存为永久配置。
		移入新文件夹／创建新文件夹。您可以通过将其放入文件夹对运行/调试配置进行分组。要创建文件夹，请在某个分类中选择配置，点击，并指定文件夹名称。如果仅选中了某个类别，则会创建一个空文件夹。随后，要将某个配置移入文件夹、在文件夹之间移动或移出文件夹，请使用拖动操作，或使用和按钮。要取消分组，请选择一个文件夹并点击。
		点击此按钮按字母顺序排序配置。

常用选项

项目	描述
名称(N)	为运行配置指定名称，便于在编辑或运行时快速识别。
允许多个实例(U)	允许并行运行此运行配置的多个实例。默认情况下，该选项处于禁用状态。当您在另一个实例仍在运行时启动此配置，PyCharm 会建议先停止正在运行的实例，再启动另一个实例。当某个运行配置占用大量资源且没有充分理由运行多个实例时，这将很有帮助。
存储为项目文件(S)	将包含运行配置设置的文件保存下来，以便与团队其他成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，可以将该配置保存到项目内的任何其他目录。默认情况下，该选项处于禁用状态，并且 PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。

项目

描述

名称(N)

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

允许多个实例(U)

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

默认情况下，该选项处于禁用状态。当您在另一个实例仍在运行时启动此配置，PyCharm 会建议先停止正在运行的实例，再启动另一个实例。当某个运行配置占用大量资源且没有充分理由运行多个实例时，这将很有帮助。

存储为项目文件(S)

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

默认情况下，该选项处于禁用状态，并且 PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。

Python 调试服务器专用配置选项

项目

描述

更新您的脚本

本部分包含为远程调试做准备所需的重要信息。

将 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。

启动前

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

项目	快捷方式	描述
	`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+4` 或 `Alt+5` 自行为其打开相应的工具窗口。
聚焦工具窗口		选中此复选框可在启动运行/调试配置时，自动将焦点移动到运行或调试工具窗口。

2026年 3月 24日