PyCharm 2025.2 Help

Python 控制台

工具 | Python 控制台

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

使用 Python 控制台

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

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

Python 控制台中的代码补全

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

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

查看数据结构

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

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

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

在控制台中运行编辑器中的源代码

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

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

  3. 观察代码选择的执行:

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

运行 asyncio 协程

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

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

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

    在控制台中执行 asyncio 协程

配置 Python 控制台设置

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

  2. Python 解释器 列表中选择任何可用的解释器。

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

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

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

运行多个 Python 控制台

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

  2. 默认情况下,每个控制台的名称为 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年 9月 26日