llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

终端

IntelliJ IDEA 包含一个嵌入式终端模拟器,可直接从 IDE 使用命令行工具。 使用它管理 Git 仓库、启动 Java 工具、设置文件权限、使用 AI 编码代理,以及执行其他命令行任务,而无需切换到专用终端应用程序。

启用 Terminal 插件

此功能依赖于 Terminal 插件,该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 插件。

  2. 找到 终端 插件并点击 启用。

终端由 libghostty 提供支持,这是来自 Ghostty 项目的终端模拟库。

初始情况下,终端模拟器使用默认系统 shell 运行,但它支持许多其他 shell,包括 Windows PowerShell、命令提示符、 sh、 bash、 zsh、 csh 等。 有关更改 shell 的更多信息,请参阅 终端设置。 要在不更改默认 shell 的情况下在单个选项卡中运行另一个 shell,请参阅 在另一个 shell 中启动会话。

访问终端工具窗口

  • 转到 视图|工具窗口|终端 或按 Alt+F12。

    默认情况下,终端模拟器运行时,将当前目录设置为当前 project 的根目录。 有关更改默认起始目录的更多信息,请参阅 终端设置。

  • 右键点击任意文件(例如,在 项目 工具窗口(Alt+1 )或任意打开的编辑器选项卡中),然后选择 在 终端 中打开 ,以在该文件所在目录中用新会话打开 终端 工具窗口。

终端会话

本地会话

开始一个新的本地会话

  • 要在单独的选项卡中开始新的会话,请点击工具栏上的 "添加"按钮 或按 Ctrl+Shift+T。

    终端中的新会话
  • 要关闭选项卡,请点击终端工具栏上的 关闭按钮 或按 Ctrl+F4。

  • 要终止正在运行的会话,请点击 关闭按钮 关闭选项卡,然后确认终止进程。

  • 要在活动选项卡之间切换,请按 Alt+Right 和 Alt+Left。 或者,您可以按 Alt+Down 查看所有终端选项卡的列表。

  • 要清除终端屏幕,请按 ⌘ K。

关闭 project 或 IntelliJ IDEA 时,终端会保存选项卡和会话。 它会保留标签名称、当前工作目录,甚至是 shell 历史记录。

预定义会话

IntelliJ IDEA 会自动检测预定义会话的常用 shell,并可在新标签页中运行其中任意一种。 选择的 shell 仅应用于当前标签页,不会影响其他标签页。 新创建的标签页会继续使用在 终端设置 中指定的默认 shell。

在检测到的 shell 中启动会话

  1. 在终端工具栏上,点击 “新建预定义会话”按钮新建预定义会话。

    在检测到的 shell 中启动预定义会话
  2. 从列表中选择一个 shell。 IntelliJ IDEA 会打开一个以该 shell 的名称命名的新标签页,并在其中启动会话。

该列表包含以下 shell:

  • 在 Windows 上: Windows PowerShell、 命令提示符、 PowerShell 终端、 Git Bash 终端 以及已安装的 WSL 发行版。

  • 在 macOS 和 Linux 上: bash、 zsh、 fish 以及在 /bin 、 /usr/bin 、 /usr/local/bin 和 /opt/homebrew/bin 中找到的 pwsh。

这些位置之外的 shell 以及其他 shell 类型不会自动检测到。 要使用它们,请在 Shell 路径 选项(位于 设置 | 工具 | 终端 )中指定可执行文件的路径。

如果检测到的多个 shell 具有相同名称,IntelliJ IDEA 会将它们的路径附加到名称后,例如 zsh (/bin/zsh) 和 zsh (/opt/homebrew/bin/zsh)。

如果 project 位于 WSL 或 Dev 容器中,列表会按环境对 shell 分组,以便在该环境或主机上启动会话。

SSH 会话

启用 SSH 远程运行插件

此功能性依赖于 SSH 远程运行 插件,该插件默认随 IntelliJ IDEA 捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 插件。

  2. 找到 SSH 远程运行 插件,然后点击 启用。

开始新的 SSH 会话

  1. 在终端工具栏上,点击 开始新的 SSH 会话 并选择 新建 SSH 会话。

    开始新的 SSH 会话
  2. 输入要连接的主机地址并提供身份验证数据。

    在 SSH 会话对话框中提供数据

    或者,如果您已配置 SSH 配置 ,您可以从列表中选择其中一个。

要终止连接,请在终端选项卡中点击 终止会话。

在终端中工作

  • 要在终端会话中搜索特定字符串,请按 Ctrl+F。 此操作会搜索会话中的所有文本:提示、命令和输出。

默认情况下,搜索不区分大小写。 可以在搜索字段中点击 “匹配大小写”图标 (区分大小写 ),使其区分大小写。

重命名终端选项卡

  • 右键点击选项卡并从上下文菜单中选择 重命名会话。

在终端中使用补全

IntelliJ IDEA 提供对命令名称、选项和参数的补全,例如路径、 Git 分支、标志等。

输入时,建议会自动显示在 终端 工具窗口中。 默认情况下,IntelliJ IDEA 会显示形参建议。

  • 要为子命令、形参和实参启用补全,请转到 设置 | 工具 | 终端 | 命令补全 ,然后选择 始终 作为 在键入时显示补全弹出窗口 选项。

  • 要手动调用补全弹出窗口,请按 Ctrl+Space。

  • 要接受建议,请在列表中选择它并按 Enter。

终端中的命令补全

终端会识别并高亮显示指向文件和文件夹的绝对路径和相对路径。 将鼠标悬停在这些路径上时,它们会显示为超链接。 这样可以快速导航到编译消息、构建错误或 AI 编码代理响应中引用的位置。

  • 按住 Ctrl 并点击终端中的文件名称,以在编辑器中打开该文件。

  • 按住 Ctrl 并点击终端中带有文件夹名称的链接,以在 项目 工具窗口中定位它。 如果文件夹位于当前项目之外,IntelliJ IDEA 将打开默认文件系统资源管理器。

  • 或者,点击文件或文件夹名称,并使用工具提示中的 打开 链接。

将文件和文件夹拖放到终端中

可以将文件和文件夹从 项目 工具窗口(Alt+1 )或系统文件管理器拖拽到 终端 工具窗口。 结果取决于放置项目的位置。

  • 将文件或文件夹拖放到终端输出区域(1)可在当前会话的提示符处粘贴其路径。

    当向 CLI 编码代理发送文件上下文,或运行以路径作为实参的命令时,此功能很有用。

  • 将文件或文件夹拖放到终端标签区域(2)即可打开新标签页,工作目录将设置为所拖放的文件夹或文件的父文件夹。

将文件拖到终端工具窗口中

自定义终端布局

安排终端选项卡以匹配工作流:并排显示多个会话,在编辑器区域中打开会话,或将 终端 工具窗口从主窗口分离。

拆分终端选项卡

可以将 终端 工具窗口拆分为若干组选项卡,并同时处理多个会话。 例如,在一个组中运行 CLI 编码代理,在另一个组中运行其他 shell 命令。 通过拆分操作打开的新选项卡会在原始选项卡的工作目录中启动会话。

使用“向右拆分”将终端工具窗口拆分为两组选项卡
  • 要在当前选项卡旁边打开新选项卡,请右键点击该选项卡并选择 向右拆分 或 向下拆分。

  • 要将标签页移动到单独的组,请右键点击该标签页并选择 拆分并右移 或 拆分并下移。 当组中包含多个标签页时,这些选项可用。

  • 或者,将标签页拖到 终端 工具窗口的任意边缘。 IntelliJ IDEA 会高亮显示新组出现的区域。 要将标签页移动到现有组,请将其拖到该组的标签页页眉上。

  • 要在组之间移动焦点,请点击某个组,或转到 窗口 | 活动工具窗口 | 转到下一个拆分器 (⌥ ⇥ )或 转到上一个拆分器 (⌥ ⇧ ⇥)。

  • 要合并拆分的标签页组,请右键点击标签页并选择 取消拆分。 如果此前多次拆分了工具窗口,请对每个拆分重复此操作。 或者,将某个组的所有标签页拖到另一个组的标签页页眉上。 当关闭或移动某个组的最后一个标签页时,该组会被自动移除。

在编辑器中打开终端标签页

可以将标签页从 终端 工具窗口移动到编辑器区域,并将其用作常规编辑器标签页。

  • 右键点击 终端 工具窗口中的选项卡,然后选择 作为编辑器标签页打开 (Alt+Shift+Enter ),或将该选项卡拖到编辑器区域。

    如果移动工具窗口中的最后一个标签页, 终端 工具窗口会自动隐藏。

  • 要将标签页移回,请在编辑器中右键点击该标签页并选择 返回工具窗口 ,或将其拖到 终端 工具窗口。

这会让会话占用编辑器区域的完整高度,有助于跟踪长时间运行的命令输出或使用 CLI 编码代理。 标签页移动时,会话会继续运行,因此命令历史记录和输出会被保留。

要使 终端 工具窗口浮动在 IDE 上方或将其移动到单独的窗口,请更改其 视图模式。

终端引擎

目前,IntelliJ IDEA 中提供以下终端引擎:

  • 重新设计(默认). 从版本 2025.2 开始,这是 IntelliJ IDEA 中的默认终端引擎。 它旨在结合 Classic 模拟器的稳定性与提升的性能、兼容性和现代化增强功能。

  • 经典. 这是先前生成的标准终端模拟器,基于 JediTerm 库构建,用户输入(命令和按键)会直接发送到底层 shell。

该 2024 实验版(已弃用) 终端引擎,在 IntelliJ IDEA 2024.* 中也称为 New Terminal,因兼容性挑战已被弃用。 选择此终端引擎的选项仅适用于已在 IntelliJ IDEA 2024.* 中启用它的用户。 可以在 IntelliJ IDEA 帮助的早期版本 中找到它的文档。

选择终端引擎

  1. 打开 终端 工具窗口: 视图|工具窗口|终端。

  2. 在工具窗口页眉中,点击 选项 并选择一个终端引擎。

    选择终端引擎

    或者,打开 IDE 设置(Ctrl+Alt+S )并进入 工具 | 终端 | 终端引擎。

配置终端

配置终端仿真器

  • 按 Ctrl+Alt+S 打开设置,然后选择 工具 | 终端。

  • 或者,点击 ,然后选择 设置。

有关更多信息,请参见 终端设置。

配置已执行命令之间的分隔符

为了更好地区分命令的开始和结束位置,可以在终端中启用分隔符。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 工具 | 终端。

  2. 使用 在已执行的命令之间显示分隔符 选项启用或禁用分隔符。

    已启用命令分隔符
    已禁用命令分隔符
  3. 请点击 应用 以保存更改。

终端中的 JDK

IntelliJ IDEA 会在内置终端中提供为项目配置的 JDK。 当设置 项目 SDK 时,IntelliJ IDEA 会将其添加到每个终端会话的 JAVA_HOME 和 路径 环境变量中。 这样,可以直接在终端中运行 java、 javac ,以及构建工具,如 ./gradlew 或 mvn ,无需单独在系统上安装或配置 JDK。

终端会跟随项目 SDK:在 文件 | 项目结构 | 项目设置 | 项目 更改后,IntelliJ IDEA 会更新新终端会话使用的 JDK。

此行为由 将项目 JDK 添加到 PATH 选项在 设置 | 工具 | 终端 中控制,默认启用。

正在运行的 shell 会话里的环境变量无法追溯更改。 如果 终端 工具窗口已打开,在切换项目 JDK 或切换 将项目 JDK 添加到 PATH 选项时,IntelliJ IDEA 会提示启动新终端会话。

从终端配置 JDK

如果在终端运行 Java 命令但 IntelliJ IDEA 未找到 JDK,则会在终端输出中显示 配置 JDK 链接。 点击该链接即可打开 项目结构 对话框,在其中可下载并 配置 JDK。

2026年 11月 3日