终端仿真器
PyCharm 包含一个嵌入式终端模拟器,可直接从 IDE 使用命令行工具。 使用它管理 Git 仓库、设置文件权限、使用 AI 编码代理,以及执行其他命令行任务,而无需切换到专用的终端应用程序。
启用 Terminal 插件
此功能依赖 Terminal 插件,该插件在 PyCharm 中默认捆绑并启用。 如果相关功能不可用,请确保没有禁用该插件。
按下 Ctrl+Alt+S 以打开设置,然后选择 。
找到 终端 插件并点击 启用。
终端由 libghostty 提供支持,这是来自 Ghostty 项目的终端模拟库。
最初,终端模拟器会使用默认系统 shell 运行,但它支持许多其他 shell,包括 Windows PowerShell、命令提示符、 sh、 bash、 zsh、 csh 等。 有关更改 shell 的更多信息,请参阅 终端设置。 要在单个选项卡中运行另一个 shell 而不更改默认 shell,请参阅 在另一个 shell 中启动会话。
访问终端工具窗口
转到 ,或按 Alt+F12。
在任意文件上右键点击(例如在 项目 工具窗口(Alt+1 )或任何打开的编辑器选项卡中),然后选择 ,以在该文件所在目录打开带有新会话的 终端 工具窗口。
终端会话
本地会话
启动新的本地会话
要在单独的选项卡中启动新会话,请在工具栏上点击
,或按 Ctrl+Shift+T。
要关闭标签页,请在终端工具栏上单击
,或按 Ctrl+F4。
要终止正在运行的会话,请单击
关闭选项卡,并确认终止该进程。
要在活动选项卡之间切换,请按 Alt+Right 和 Alt+Left。 或者,您可以按 Alt+Down 查看所有终端选项卡的列表。
要清除终端屏幕,请按 ⌘ K。
在您关闭 项目 或 PyCharm 时,终端会保存标签页和会话。 它会保留选项卡名称、当前工作目录,甚至 shell 历史记录。
预定义会话
PyCharm 会自动检测预定义会话的常见 shell,并可在新标签页中运行其中任意一个。 选择的 shell 仅适用于当前标签页,不会影响其他标签页。 新建的标签页会继续使用 终端设置 中指定的默认 shell。
在检测到的 shell 中启动会话
在终端工具栏上,点击
新建预定义会话。

从列表中选择一个 shell。 PyCharm 会打开以该 shell 命名的新标签页,并在其中启动会话。
列表包含以下 shell:
在 Windows 上: Windows PowerShell、 命令提示符、 PowerShell、 Git Bash ,以及已安装的 WSL 发行版。
在 macOS 和 Linux 上:
bash、zsh、fish和pwsh,可在 /bin 、 /usr/bin 、 /usr/local/bin 和 /opt/homebrew/bin 中找到。
位于这些位置之外的 shell 以及其他 shell 类型不会被自动检测到。 要使用它们,请指定 Shell 路径 选项中可执行文件的路径,该选项位于 中。
如果检测到的多个 shell 具有相同名称,PyCharm 会将其路径追加到名称中,例如 zsh (/bin/zsh) 和 zsh (/opt/homebrew/bin/zsh)。
如果 项目 位于 WSL 或 Dev Container 中,列表会按环境对 shell 分组,以便在该环境或主机上启动会话。
SSH 会话
启用 SSH Remote Run 插件
此功能依赖于 SSH Remote Run 插件,该插件在 PyCharm 中默认捆绑并启用。 如果相关功能不可用,请确保没有禁用该插件。
按下 Ctrl+Alt+S 以打开设置,然后选择 。
找到 SSH Remote Run 插件并点击 启用。
启动新的 SSH 会话
在终端工具栏上,单击
,然后选择 新建 SSH 会话。

输入要连接的主机地址并提供身份验证凭据。

或者,如果您已配置 SSH 配置 ,可以在列表中选择其中之一。
要终止连接,请在终端选项卡中点击 。
在终端中工作
在终端中搜索
要在终端会话中搜索特定字符串,请按 Ctrl+F。 这会搜索会话中的所有文本:提示符、命令和输出。
默认情况下,搜索不区分大小写。 您可以在搜索字段中单击 (区分大小写 )使其区分大小写。
重命名终端选项卡
右键点击该选项卡,并从上下文菜单中选择 重命名会话。
在终端中使用补全
PyCharm 为命令名称、选项和参数提供补全,例如路径、Git 分支、标志等。
在您键入时,建议会自动显示在 终端 工具窗口中。 默认情况下,PyCharm 会显示参数建议。
要启用对子命令、参数和实参的补全,请转到 ,并为 在输入时显示补全弹出窗口 选项选择 始终。
要手动调用补全弹出窗口,请按 Ctrl+Space。
要接受建议,请在列表中选择该建议并按 Enter。

从终端导航到文件和文件夹
终端能够识别并高亮显示文件和文件夹的绝对路径和相对路径。 将鼠标悬停在其上时,会显示为超链接。 这样可以让您快速导航到编译消息、构建错误或 AI 编码代理响应中引用的位置。
按住 Ctrl 并点击终端中的文件名即可在编辑器中打开该文件。
按住 Ctrl 并点击终端中带有文件夹名称的链接,即可在 项目 工具窗口中定位它。 如果某个文件夹位于当前项目之外,PyCharm将打开默认文件系统资源管理器。
或者,点击文件或文件夹名称并在工具提示中使用 打开 链接。
将文件和文件夹拖放到终端中
可以将文件和文件夹从 项目 工具窗口(Alt+1 )或系统文件管理器拖入 终端 工具窗口。 结果取决于放置该项的位置。
将文件或文件夹拖放到终端输出区域 (1),即可在当前会话的提示符粘贴其路径。
当向 CLI 编码代理发送文件上下文,或运行将路径作为实参的命令时,这会很有用。
将文件或文件夹拖放到终端标签区域 (2),即可打开新标签页,工作目录将设置为所拖文件夹,或所拖文件的父文件夹。

自定义终端布局
排列终端选项卡以匹配工作流:并排显示多个会话、在编辑器区域中打开会话,或将 终端 工具窗口从主窗口中分离。
拆分终端选项卡
可以将 终端 工具窗口拆分为几组选项卡,并同时处理多个会话。 例如,在一个组中运行 CLI 编码代理,在另一个组中运行其他 shell 命令。 通过拆分操作打开的新选项卡会在原始选项卡的工作目录中启动会话。

要在当前选项卡旁边打开新选项卡,请右键点击该选项卡,然后选择 向右拆分 或 向下拆分。
要将选项卡移动到单独的组,请右键点击它,然后选择 拆分并右移 或 拆分并下移。 这些选项在组包含多个选项卡时可用。
或者,将选项卡拖动到 终端 工具窗口的任意边缘。 PyCharm 会高亮显示新组出现的区域。 要将选项卡移动到现有组,请将其拖动到该组的选项卡标题。
要在组之间移动焦点,请点击某个组,或转到 (⌥ ⇥ )或 转到上一个拆分器 (⌥ ⇧ ⇥)。
要合并拆分的选项卡组,请右键点击选项卡并选择 取消拆分。 如果之前多次拆分了工具窗口,请对每个拆分重复该操作。 或者,将一个组的所有选项卡拖动到另一个组的选项卡标题。 关闭或移动组中的最后一个选项卡时,该组会被自动移除。
在编辑器中打开终端标签页
可以将标签页从 终端 工具窗口移动到编辑器区域,并将其用作常规编辑器标签页。
右键点击 终端 工具窗口中的选项卡,然后选择 作为编辑器标签页打开 (Alt+Shift+Enter ),或将该选项卡拖动到编辑器区域。
如果移动工具窗口中的最后一个标签页, 终端 工具窗口会自动隐藏。
要将标签页移回,请在编辑器中右键点击它并选择 返回工具窗口 ,或将其拖动到 终端 工具窗口。
这样会使会话占用编辑器区域的完整高度,有助于查看长时间运行命令的输出,或使用 CLI 编码代理。 标签页移动期间,会话会继续运行,因此命令历史记录和输出会保留。
要将 终端 工具窗口浮动在 IDE 上方,或将其移动到单独的窗口,请更改其 视图模式。
终端引擎
当前,PyCharm 中提供以下终端引擎:
改进版(默认)。 从 2025.2 版本开始,这是 PyCharm 中的默认终端引擎。 其旨在将经典仿真器的稳定性与改进的性能、兼容性和现代增强功能相结合。
经典。 这是上一代的标准终端仿真器,基于 JediTerm 库构建,用户输入(命令和按键)会直接发送到底层 shell。
2024 实验版(已弃用) 终端引擎(在 PyCharm 2024.* 中也称为 New Terminal)因兼容性问题而被弃用。 仅对在 PyCharm 2024.* 中启用过该终端引擎的用户提供选择该终端引擎的选项。 您可以在 早期版本的 PyCharm 帮助 中找到其文档。
选择终端引擎
打开 终端 工具窗口: 。
在工具窗口标题中,点击
,并选择一个终端引擎。

或者,打开 IDE 设置(Ctrl+Alt+S ),然后转到 。
配置终端
配置终端仿真器
按下 Ctrl+Alt+S 以打开设置,然后选择 。
或者,点击终端工具栏上的
,并选择 设置。
有关更多信息,请参见 终端设置。
配置已执行命令之间的分隔符
为更好地区分命令的开始和结束,您可以在终端中启用分隔符。
按下 Ctrl+Alt+S 以打开设置,然后选择 。
使用 在已执行的命令之间显示分隔符 选项启用或禁用分隔符。


点击 Apply 以保存更改。