终端
PhpStorm 包含一个嵌入式终端模拟器，可用于直接从 IDE 使用命令行工具。 使用它管理 Git 仓库、设置文件权限、使用 AI 编码代理，以及执行其他命令行任务，而无需切换到专用终端应用程序。
启用 Terminal 插件
此功能依赖于 Terminal 插件，该插件默认在 PhpStorm 中捆绑并启用。 如果相关功能不可用，请确保您未禁用该插件。
按 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。
关闭 项目 或 PhpStorm 时，终端会保存选项卡和会话。 它会保留标签名称、当前工作目录，甚至是 shell 历史记录。
预定义会话
PhpStorm 会自动检测用于预定义会话的常见 shell，并可以在新选项卡中运行其中任意一个。 所选 shell 仅应用于当前选项卡，不会影响其他选项卡。 新创建的选项卡会继续使用在 终端设置 中指定的默认 shell。
在检测到的 shell 中启动会话
在终端工具栏上，点击
新建预定义会话。
从列表中选择一个 shell。 PhpStorm 会打开一个以该 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 具有相同名称，PhpStorm 会将它们的路径附加到名称后，例如 zsh (/bin/zsh) 和 zsh (/opt/homebrew/bin/zsh)。
如果 项目 位于 WSL 或 Dev Container 中，列表会按环境对 shell 分组，以便可以在该环境或主机上启动会话。
SSH 会话
启用 SSH 远程运行插件
此功能依赖于 SSH 远程运行 插件，该插件默认在 PhpStorm 中捆绑并启用。 如果相关功能不可用，请确保您未禁用该插件。
按 Ctrl+Alt+S 打开设置，然后选择 。
找到 SSH 远程运行 插件并点击 启用。
开始新的 SSH 会话
在终端工具栏上，点击
并选择 新建 SSH 会话。 
输入要连接的主机地址，并提供身份验证数据。
或者，如果您已配置 SSH 配置 ，您可以从列表中选择其中一个。
要终止连接，请在终端选项卡中点击 。
在终端中工作
在终端中搜索
要在终端会话中搜索特定字符串，请按 Ctrl+F。 此操作会搜索会话中的所有文本：提示、命令和输出。
默认情况下，搜索不区分大小写。 可以点击搜索字段中的 
（区分大小写 ）使其区分大小写。
重命名终端选项卡
右键点击选项卡并从上下文菜单中选择 重命名会话。
在终端中使用补全
PhpStorm 提供对命令名称、选项和参数的补全，例如路径、 Git 分支、标志等。
键入时，建议会自动显示在 终端 工具窗口中。 默认情况下，PhpStorm 会显示参数建议。
要启用子命令、参数和实参的补全，请转到 ，并选择 始终 作为 在键入时显示补全弹出窗口 选项的值。
要手动调用补全弹出窗口，请按 Ctrl+Space。
要接受建议，请在列表中选择它并按 Enter。
从终端导航到文件和文件夹
终端会识别并高亮显示文件和文件夹的绝对路径与相对路径。 将鼠标悬停在其上时，它们会显示为超链接。 这样可以快速导航到编译消息、构建错误或 AI 编码代理响应中引用的位置。
按住 Ctrl 并点击终端中的文件名称，以在编辑器中打开该文件。
按住 Ctrl 并点击终端中带有文件夹名称的链接，以在 项目 工具窗口中定位该文件夹。 如果文件夹位于当前项目之外，PhpStorm 将打开默认文件系统资源管理器。
或者，点击文件或文件夹名称，并使用工具提示中的 打开 链接。
将文件和文件夹拖放到终端
可以将文件和文件夹从 项目 工具窗口（Alt+1 ）或系统文件管理器拖放到 终端 工具窗口中。 结果取决于放置项目的位置。
将文件或文件夹拖放到终端输出区域 (1)，即可在当前会话的提示符下粘贴其路径。
当向 CLI 编码代理发送文件上下文，或运行以路径作为实参的命令时，这很有用。
将文件或文件夹拖到终端标签区域（2），即可打开一个新标签页，工作目录会设置为所拖文件夹，或为所拖文件的父文件夹。
自定义终端布局
排列终端选项卡以匹配您的工作流：并排显示多个会话、在编辑器区域打开会话，或将 终端 工具窗口从主窗口中分离出来。
拆分终端选项卡
可以将 终端 工具窗口拆分为几组选项卡，并同时处理多个会话。 例如，在一个组中运行 CLI 编码代理，在另一个组中运行其他 shell 命令。 通过拆分操作打开的新选项卡会在原始选项卡的工作目录中启动会话。
要在当前选项卡旁边打开新选项卡，请右键点击选项卡并选择 向右拆分 或 向下拆分。
要将标签页移动到单独的组，请右键点击该标签页并选择 拆分并右移 或 拆分并下移。 当组包含多个标签页时，这些选项可用。
或者，将标签页拖动到 终端 工具窗口的任意边缘。 PhpStorm 会高亮显示新组出现的区域。 要将标签页移动到现有组，请将其拖动到该组的标签页页眉。
要在组之间移动焦点，请点击某个组，或转到 （⌥ ⇥ ）或 转到上一个拆分器 （⌥ ⇧ ⇥）。
要合并拆分的标签页组，请右键点击标签页并选择 取消拆分。 如果之前多次拆分了工具窗口，请对每个拆分重复此操作。 或者，将某个组的所有标签页拖动到另一个组的标签页页眉。 当关闭或移动某个组的最后一个标签页时，该组会被自动移除。
在编辑器中打开终端选项卡
可以将选项卡从 终端 工具窗口移动到编辑器区域，并将其用作常规编辑器选项卡。
右键点击 终端 工具窗口中的选项卡，然后选择 作为编辑器标签页打开 (Alt+Shift+Enter )，或将选项卡拖到编辑器区域。
如果移动工具窗口中的最后一个选项卡， 终端 工具窗口会自动隐藏。
要将选项卡移回，请在编辑器中右键点击该选项卡并选择 返回工具窗口 ，或将其拖动到 终端 工具窗口。
这样会使会话占用编辑器区域的完整高度，在跟踪长时间运行命令的输出或使用 CLI 编码代理时很有帮助。 选项卡移动时，会话会继续运行，因此命令历史记录和输出会保留。
要使 终端 工具窗口浮动在 IDE 上方或将其移动到单独的窗口，请更改其 视图模式。
终端引擎
目前，PhpStorm 中提供以下终端引擎：
重构版（默认）. 从 2025.2 版本开始，这是 PhpStorm 中的默认终端引擎。 它旨在将经典模拟器的稳定性与改进的性能、兼容性和现代增强功能结合起来。
经典. 这是上一生成的标准终端模拟器，基于 JediTerm 库构建，用户输入（命令和按键）会直接发送到底层 shell。
2024 实验版(已弃用) 终端引擎在 PhpStorm 2024.* 中也称为 New Terminal，由于兼容性挑战已被弃用。 仅对曾在 PhpStorm 2024.* 中启用该终端引擎的用户提供选择此终端引擎的选项。 可以在 PhpStorm 帮助的早期版本中找到它的文档。
选择终端引擎
打开 终端 工具窗口： 。
在工具窗口页眉中，点击
并选择终端引擎。
或者，打开 IDE 设置（Ctrl+Alt+S ）并进入 。
配置终端
配置终端仿真器
按 Ctrl+Alt+S 打开设置，然后选择 。
或者，点击
，然后选择 设置。
有关更多信息，请参阅 终端设置。
配置已执行命令之间的分隔符
为了更好地区分命令的开始和结束位置，可以在终端中启用分隔符。
按 Ctrl+Alt+S 打开设置，然后选择 。
使用 在已执行的命令之间显示分隔符 选项启用或禁用分隔符。
请点击 应用 以保存更改。