PyCharm 2025.1 Help

Python 控制台

Python 控制台支持逐行执行 Python 命令和脚本,类似于您在 Python Shell中的体验。

Python 控制台中可用的操作

在控制台中,您可以:

  • 输入命令并按 Enter 执行它们。 结果会显示在同一个控制台中。

  • 使用 基本代码补全 Ctrl+Space 和 Tab 补全。

  • 运行 asyncio 协程。

  • 使用 UpDown 浏览命令历史记录,并执行所需的命令。

  • 从编辑器加载源代码到控制台。

  • 使用上下文菜单将控制台内容复制到剪贴板,与剪贴板进行比较,或清除控制台。

  • 使用 工具栏按钮控制控制台中的会话。

  • 配置控制台的配色方案以满足您的偏好。 有关更多信息,请参阅 配置控制台的配色方案

  • 使用配置文件自动配置 IPython 控制台。

使用 Python 控制台

每次您在 工具 菜单中选择相应命令时,控制台都会作为工具窗口出现。 您可以分配一个快捷键来打开 Python 控制台:按 Ctrl+Alt+S ,导航到 按键映射 ,为 主菜单 | 工具 | Python 或调试控制台 指定一个快捷键。

在 PyCharm 中使用 Python 控制台的主要原因是利用主要的 IDE 功能,例如代码补全、代码分析和快速修复。

Python 控制台中的代码补全

您可以使用上下箭头键浏览已执行命令的历史记录,并重复所需的命令。 要预览执行过程中计算的变量值,请点击 显示变量 并检查 特殊变量 列表。

在 Python 控制台中显示变量

控制台适用于所有类型的 Python 解释器和虚拟环境,包括本地和远程。

查看数据结构

  • 当在 Python 控制台 中查看变量时,您可以点击 作为数组查看作为DataFrame 查看作为系列查看 链接,以便在 数据视图 工具窗口中显示数据。

    查看数据框
  • 默认情况下,使用新的表格表示法。

    点击 更多操作 并选择 在表格表示之间切换在表格表示之间切换 以更改表格界面。

从编辑器中运行源代码到控制台

  1. 在编辑器中打开文件,并选择要执行的代码片段。

  2. 从选择的上下文菜单中选择 在Python 控制台中执行选区 ,或按 Alt+Shift+E

    执行代码选择的上下文菜单
  3. 观察代码选择的执行:

    在控制台中执行代码选择

默认情况下,Python 控制台使用为项目定义的 Python 解释器执行 Python 命令。 但是,您可以分配一个替代的 Python 解释器。

运行 asyncio 协程

  1. 在编辑器中,选择包含 asyncio 协程定义的代码片段。

  2. 从上下文菜单中选择 在Python 控制台中执行选区 ,或按 Alt+Shift+E

    在 Python 控制台中选择并执行 asyncio 协程
  3. 在 Python 控制台上执行代码后,使用 await 关键字运行协程:

    在控制台中执行 asyncio 协程

配置 Python 控制台设置

  1. 设置 对话框(Ctrl+Alt+S )中,选择 构建、执行、部署 | 控制台 | Python 控制台

  2. Python 解释器 列表中选择任何可用的解释器。 请注意,您不能在此处引入新的解释器。 如果您想创建新的解释器,您需要先 创建它。

    搜索替代的 Python 解释器
  3. 如有需要,点击 配置解释器 链接检查已安装包的列表并添加新包。

    注意 正在启动脚本 区域中的代码。 它包含在您打开 Python 控制台后将执行的脚本。 使用它预先编写一些所需的 Python 命令。

在处理多个 Python 脚本时,您可能希望在单独的 Python 控制台中执行每个脚本。

运行多个 Python 控制台

  1. 点击 新建控制台 添加一个新的 Python 控制台。

  2. 默认情况下,每个控制台的名称为 Python 控制台 加上一个索引。 要使控制台反映您正在运行的脚本,右键点击控制台选项卡,选择 重命名控制台 ,并输入任何有意义的名称。

    重命名 Python 控制台

您在 Python 控制台中运行的所有命令都会逐一执行。 如果命令需要较长时间执行,您可能希望预览和管理执行队列。

管理命令执行队列

  1. 转到 设置 | 构建、执行、部署 | 控制台 并启用 Python Console 的命令队列 复选框。

  2. 点击控制台工具栏上的 命令队列 打开队列。

    控制台命令队列
  3. Python 控制台命令队列 对话框中,查看命令列表。 如有需要,点击 移除 从队列中删除命令。

请注意,一旦命令执行完毕,它将从队列中消失。 要预览所有先前执行的命令,请浏览控制台历史记录(控制台历史记录)。

工具栏

项目

工具提示和快捷键

描述

重新运行控制台

重新运行控制台

Ctrl+F5

点击此按钮以终止当前进程并启动新进程。

停止按钮

停止

Ctrl+F2

点击此按钮以停止当前进程。

点击按钮一次会调用 soft kill ,允许应用程序捕获 SIGINT 事件并执行正常终止(在 Windows 上, Ctrl+C 事件是模拟的)。 按钮被点击一次后,它将被替换为 “Kill Process” 按钮 ,这表示后续点击将导致应用程序被强制终止,例如在 Unix 上会发送 SIGKILL

运行命令

执行当前语句

Enter

点击此按钮以执行插入符号所在位置的命令,该命令已在控制台的输入窗格中输入。

调试

附加调试器

将调试器进程附加到控制台。

设置

设置

您可以指定 Python 控制台的以下设置:

  • 简化变量视图 :选择此选项将以下名称包含到 特殊变量 组中:

    • 所有带有双下划线名称的变量。

    • 所有 functionclassobjmodule 的实例。

    • 如果已启动带有 IPython 的调试控制台,则包括所有 IPython 内部变量。

  • 变量加载策略。 您可以选择以下策略之一:

    • 同步 :如果启用此选项,显示的消息是 Collecting data ,之后调试器会显示变量的值。

    • 异步 :如果启用此选项,调试器中的变量会单独加载(异步)。 在这种情况下,如果加载变量需要较长时间,调试器会显示 ...Loading Value 消息,然后显示其值,或者如果变量加载过慢,则显示 Loading timed out 消息。 请注意警告消息,建议切换到 按需模式。

    • 按需 :如果启用此选项,调试器会显示 Show Value 消息。 点击它以启用加载。

    请注意,任何加载策略的更改在您重新运行调试过程后生效。

添加新控制台

新建控制台

点击此按钮以启动新的控制台会话。

软换行按钮

使用软换行

点击此按钮切换输出的软换行模式。

滚动到结尾

滚动到结尾

点击此按钮可导航到堆栈跟踪的底部,并将文本光标跳转到源代码中的相应位置。

打印按钮

打印

点击此按钮以将控制台文本发送至默认打印机。

调试器监视

显示变量

点击此按钮以在单独的窗格中显示控制台中声明的变量。 右键点击此窗格中的变量会显示上下文菜单。

添加新控制台

显示命令队列

点击此按钮以预览命令执行队列。

浏览查询历史按钮

浏览历史记录

Ctrl+Alt+E

打开一个对话框,显示您为相应数据源运行的所有语句。

另请参阅 使用“查询历史”对话框

上下文菜单命令

命令

快捷键

描述

与剪贴板比较 与剪贴板比较

在控制台中显示选择内容,并在 差异查看器中显示剪贴板的内容。

暂停输出

暂停 Python 脚本执行的输出

全部清除 清除所有

从上下文菜单中选择此项以删除控制台上部的所有消息。

最后修改日期: 2025年 4月 23日