# Python

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

创建：  `运行 | 编辑配置 |`  ![添加新配置](https://resources.jetbrains.com/help/img/idea/2026.3/workspace.xml` 。     |

## 工具栏

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

|  项  |  快捷方式  |  描述  |
| --- | --- | --- |
|  ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |  创建运行/调试配置。  |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  删除选定的运行/调试配置。 请注意，您不能删除默认配置。  |
|  ![复制](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)  |  `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Meta+D` (Emacs), `Ctrl+Shift+D` (Sublime Text), `⌘ ⇧ D` (Sublime Text (macOS)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  |  创建选定运行/调试配置的副本。 请注意，您正在创建默认配置的副本。  |
|  ![保存配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.save.svg)  |  |  仅当您选择一个 [临时配置](null)时才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。  |
|  ![移动到新文件夹／创建新文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.newFolder.svg)  |  |     移入新建文件夹／新建文件夹。 您可以通过 [将它们放入文件夹](run-debug-configuration.html#config-folders)来对运行/调试配置进行分组。       要创建文件夹，请选择某个类别中的配置，点击 ![文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.folder.svg)，并指定文件夹名称。 如果只有一个类别处于焦点状态，则会创建一个空文件夹。       然后，为了将配置移动到文件夹中、文件夹之间或者文件夹外，请使用拖拽或 ![上移](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg) 和 ![下移](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) 按钮。       要删除分组，请选择一个文件夹，然后点击 ![删除配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)。     |
|  ![排序配置](https://resources.jetbrains.com/help/img/idea/2026.3/workspace.xml` 。     |

## Python 特定配置选项

|  项  |  描述  |
| --- | --- |
|  Python 解释器  |  选择一个预配置的 [Python 解释器](configuring-available-python-interpreters.html)。  |
|  脚本路径/模块名称  |     点击列表以选择要运行的目标类型。 然后，在相应字段中指定要执行的 Python 脚本路径或模块名称。       您可以在此字段中使用 [路径变量](absolute-path-variables.html)。     |
|  参数  |     在此字段中，指定要传递给 Python 脚本的参数。       在指定脚本参数时，请遵循以下规则：        * 使用空格分隔单个脚本参数。    * 包含空格的脚本参数应使用双引号括起来，例如 `some" "param` 或 `"some param"` 。    * 如果脚本参数包含双引号，请使用反斜杠转义双引号，例如： ``` -s"main.snap_source_dirs=[\"pcomponents/src/main/python\"]" -s"http.cc_port=8189" -s"backdoor.port=9189" -s"main.metadata={\"location\": \"B\", \"language\": \"python\"}" ```    |
|  工作目录  |     指定运行任务所需的目录。        * 当通过键盘快捷键 `Ctrl+Shift+F10` (Windows), `⌃ ⇧ R` (macOS), `⌃ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ R` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `Ctrl+Shift+F10` (Sublime Text (macOS)), `⌘ ⌥ U` (Xcode), `Ctrl+Alt+F5` (Visual Studio), `⌃ ⌥ F5` (Visual Studio (macOS)), `Ctrl+Alt+F5` (ReSharper), `⌃ ⌥ F5` (ReSharper (macOS)), `Ctrl+Shift+F10` (QtCreator), `⌃ ⇧ R` (QtCreator (macOS)), `Alt+Shift+F6` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌃ ⇧ R` (Eclipse (macOS)) 创建默认运行/调试配置，或从脚本的上下文菜单选择 `运行` 时，工作目录为包含可执行脚本的目录。 此目录可能与项目目录不同。    * 当该字段留空时，将使用 CLion 安装的 `bin` 目录。      您可以在此字段中使用 [路径变量](absolute-path-variables.html)。     |
|  环境变量  |     此字段显示环境变量列表。 如果列表包含多个变量，它们使用分号分隔。       默认情况下，该字段包含变量  `PYTHONUNBUFFERED` ，其值为 1。 要填写列表，请点击浏览按钮，或按 `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⇧ ⏎` (Xcode), `Shift+Enter` (Visual Studio), `⇧ ⏎` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⇧ ⏎` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `⌘ ⏎` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⇧ ⏎` (Eclipse (macOS)) 并在   环境变量   对话框中指定所需的一组环境变量。       要创建新变量，请点击 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后输入所需的名称和值。   您可能希望用存储为文本文件中一系列记录的变量来填充列表，例如：    ```PLAINTEXT Variable1 = Value1 Variable2 = Value2  ```  只需从文本文件中复制变量列表，然后点击   粘贴  （ ![粘贴](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.paste.svg)）在   环境变量  对话框中。 这些变量将被添加到表格中。 点击   确定   完成任务。 您可以随时在   环境变量  对话框中选择所有变量，点击   复制   ![复制](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)，然后将它们粘贴到文本文件中。  |
|  启动时打开运行/调试工具窗口  |  使用此选项可在配置执行时自动打开运行/调试工具窗口。  |
|  将内容根添加到 PYTHONPATH  |  选中此复选框以将项目的所有 [内容根](null) 添加到环境变量 PYTHONPATH。  |
|  将源代码根添加到 PYTHONPATH  |  选中此复选框以将项目的所有 [源根](null) 添加到环境变量 PYTHONPATH。  |
|   Docker 容器设置    > **Warning:** > 仅当为项目选择了 [基于 Docker 的远程解释器](docker.html) 时，此字段才会出现。     > **Note:** > 关于某些选项（  `--net` 、  `--link`  等）的设置对应关系，请注意，这些选项来自 [Docker 命令行参数](https://docs.docker.com/engine/reference/commandline/run/)。      点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 打开对话框并指定以下设置：     |
|  选项  |      * 禁用网络 ：选中此复选框以禁用网络。 这对应于 `--net="none"` ，这意味着在容器内无法访问外部网络资源。    * 网络模式 ：对应于选项 `--net` 的其他值。 * `bridge` 是默认值。 将为容器分配一个 IP 地址，该地址位于桥接网络上，流量将通过此桥接路由到容器。 默认情况下，容器可以通过其 IP 地址通信。 若要通过名称通信，它们必须彼此链接。 * `host` ：在容器中使用主机的网络堆栈。 * `container:<name\|id>` ：使用另一个容器的网络堆栈，该容器通过其 名称 或 ID 指定。 有关更多信息，请参阅 [网络设置](https://docs.docker.com/engine/reference/run/#network-settings)文档。    * 链接 ：使用此部分将要创建的容器与其他容器链接。 这适用于 `Network mode = bridge` 并对应于 `--link` 选项。    * 发布所有端口 ：将所有容器端口暴露给主机。 这对应于 `--publish-all` 选项。    * 端口绑定 ：指定 [端口绑定](https://docs.docker.com/engine/reference/run/#expose-incoming-ports) 的列表。 与使用 `-p` 选项 `docker run` 类似。    * 额外主机 ：对应于 `--add-host` 选项。 有关更多信息，请参阅 [管理 /etc/hosts](https://docs.docker.com/engine/reference/run/#managing-etc-hosts)。    * 卷绑定 ：使用此字段指定特殊文件夹（ 卷 ）与运行 Docker 守护进程的计算机文件夹之间的绑定。 这对应于 `-v` 选项。 有关更多信息，请参阅 [管理容器中的数据](https://docs.docker.com/userguide/dockervolumes/)。    * 环境变量 ：使用此字段指定环境变量及其值的列表。 对应于 `-e` 选项。 有关更多信息，请参阅 [ENV（环境变量）](https://docs.docker.com/engine/reference/run/#env-environment-variables)。      点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) 展开表格。 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)或 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)以组成列表。     |

## 日志选项卡

使用此选项卡指定在运行或调试时生成的哪些日志文件应显示在控制台中，即显示在 [Run](run-tool-window.html) 或 [调试工具窗口](debug-tool-window.html) 的专用选项卡上。

|  项  |  描述  |
| --- | --- |
|    将显示在控制台中的日志文件    |  |
|    是否激活    |  在此列中选择复选框，以便在 [运行工具窗口](run-tool-window.html) 或 [调试工具窗口](debug-tool-window.html) 的相应选项卡中显示日志条目。  |
|    日志文件条目    |     此列中的只读字段列出了要显示的日志文件。 列表可以包含：        * 特定文件的完整路径。    * 用于替代完整路径或模式的别名。 这些别名还显示在选项卡的标题中，以展示相应的日志文件。 如果日志条目模式定义了多个文件，则选项卡标题会显示文件名而不是日志条目别名。    |
|  ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  点击此按钮打开 [编辑日志文件别名对话框](edit-log-files-aliases-dialog.html)，您可以在其中选择新的日志条目并为其指定别名。  |
|  ![“编辑”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)  |  点击此按钮，以在 [编辑日志文件别名对话框](edit-log-files-aliases-dialog.html) 中编辑所选日志文件条目的属性。  |
|  ![删除按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  点击此按钮可从列表中删除选定的日志条目。  |
|    将控制台输出保存到文件    |  选中此复选框可将控制台输出保存到指定位置。 请手动输入路径，或点击浏览按钮并指向 [打开的对话框](select-path-dialog.html)中的目标位置。  |
|    当消息打印到标准输出流时显示控制台    |  选中此复选框以激活输出控制台，并在关联进程写入 Standard.out 时将其置于前端。  |
|    当消息打印到标准错误流时显示控制台    |  选中此复选框以激活输出控制台，并在关联的进程写入 Standard.err 时将其前置。  |
|  ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)  |  点击此按钮以编辑所选日志文件条目。 仅当选择了条目时，此按钮才可用。  |

## 附加选项

点击   修改选项  ，然后选择您要添加到对话框的选项。

### 操作系统

|  项  |  描述  |
| --- | --- |
|     允许多个实例     |     允许并行运行多个此运行配置实例。       默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，CLion建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。     |

### Python

|  项  |  描述  |
| --- | --- |
|  解释器选项  |  在此字段中，指定要传递给解释器的 [命令行选项](https://docs.python.org/3/using/cmdline.html#command-line)。 如果需要，请点击 ![展开字段](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg)，并在编辑器中键入字符串。  |
|  使用 Python 控制台运行  |  启用使用 Python 控制台运行脚本或模块。  |

### 调试

|  项  |  描述  |
| --- | --- |
|  仅调试我的代码  |  启用该选项后，调试器只关注用户编写的代码，并跳过外部库。  |

### 日志

以下选项与记录此配置的执行相关。 欲了解更多信息，请参阅 [](null)。

|  项  |  描述  |
| --- | --- |
|     指定要在控制台中显示的日志     |     指定在运行应用程序时显示哪些日志文件。       点击 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 以添加新的日志。 在   编辑日志文件别名  对话框中，配置以下内容：        * 别名 ：显示日志的选项卡的名称。    * 日志文件位置 ：请指定日志文件的路径或 [Ant pattern](https://ant.apache.org/manual/dirtasks.html)。 如果多个滚动日志文件匹配该模式，CLion 将显示最新的一个。    * 显示所有可由模式匹配的文件 ：显示所有符合模式的日志。      对于表格中的日志，您可以配置以下选项：        * 是否激活 ：显示指定的日志文件。    * 跳过内容 ：不要显示以前运行的旧日志消息。    |
|     将控制台输出保存到文件     |  将控制台输出保存到指定位置。 请手动输入路径或点击浏览按钮，并在打开的 [对话框中](select-path-dialog.html)指向所需位置。  |
|     当消息打印到 stdout 时显示控制台     |  当应用程序写入标准输出流时激活控制台。  |
|     当消息打印到 stderr 时显示控制台     |  当应用程序写入标准错误流时激活控制台。  |

### 启动前

|  项  |  描述  |
| --- | --- |
|     启动时打开运行/调试工具窗口     |     默认情况下，此选项被选中，在您启动运行/调试配置时， [Run](run-tool-window.html) 或 [Debug](debug-tool-window.html) 工具窗口会打开。       否则，工具窗口将被隐藏。 但是，当配置正在运行时，您可以通过按 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `⌘ 6` (Xcode), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (ReSharper), `⌘ 4` (ReSharper (macOS)), `Alt+3` (QtCreator), `⌘ 3` (QtCreator (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS)) 或 `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `⌘ 7` (Xcode), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (ReSharper), `⌘ 5` (ReSharper (macOS)), `Alt+5` (QtCreator), `⌘ 5` (QtCreator (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS)) 自行打开相应的工具窗口。     |
|     启动时聚焦运行/调试工具窗口     |     选择此选项后，启动运行/调试配置时会自动将焦点移动到 [Run](run-tool-window.html) 或 [Debug](debug-tool-window.html) 工具窗口。     |
|     启动前显示运行/调试配置设置     |     选择此选项可在实际启动运行/调试配置前显示运行/调试配置设置。     |
|     添加启动前任务     |     选择此选项以添加下列可用任务之一：        * 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择一个或多个您想要运行的应用程序。 如果它在 CLion 中尚未定义，请添加其定义。 如需更多信息，请参阅 [外部工具](configuring-third-party-tools.html)和 [外部工具](settings-tools-external-tools.html)。    * 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 [复合运行/调试配置](run-debug-multiple.html#compound-configs)。    * 运行 File Watchers​ ：选择此选项以让 CLion 应用所有当前活动的 [文件监视器](using-file-watchers.html)。    * 运行 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](null)。    * 编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为: * 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。 * 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。    * 生成 CoffeeScript 源地图 ：选择此选项以生成 [CoffeeScript](coffeescript.html) 源代码的源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。    |

## See also

### 概念

[运行/调试配置](run-debug-configuration.html)

