终端

启用 Terminal 插件

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

1. 按 Ctrl+Alt+S 打开设置，然后选择 Plugins。

2. 打开 已安装 选项卡，找到 Terminal 插件，并勾选插件名称旁边的复选框。

访问终端工具窗口

• 请前往 视图｜工具窗口｜终端 或按 Alt+F12。

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

• 右键点击任意文件（例如，在 Project 工具窗口 (Alt+1) 或任何打开的编辑器标签页中），然后选择 在 终端 中打开 以在该文件目录中以新会话方式打开 终端 工具窗口。

开始一个新的本地会话

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

• 要在一个选项卡中运行多个会话，请右键点击该选项卡，并在上下文菜单中选择 向右拆分 或 拆分。

• 关闭 project 或 PhpStorm 时，终端会保存标签页与会话。它会保留标签名、当前工作目录以及 shell 历史记录。 它会保留标签名称、当前工作目录，甚至是 shell 历史记录。

  要关闭标签页，请点击终端工具栏上的 ，或按下 Ctrl+F4。

• 要终止正在运行的会话，请通过点击 关闭标签页，并确认终止该进程。

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

• 要清除终端屏幕，请按 Ctrl+L。

开始新的 AI Agent 会话。

• 在终端工具栏，点击 AI 代理 下拉菜单，并选择代理以开始会话：

  • Junie

  • Claude Code

  • Codex

  

• 开始会话后， AI 代理 标题会被显示所选代理名称的按钮替换。 这样可以快速使用同一代理重新开始会话。 你仍然可以打开下拉菜单选择其他代理。

• 如果你的机器上未安装 Junie CLI，可以直接在终端进行安装。 在终端工具栏，点击 AI 代理 下拉菜单，并选择 安装 Junie.。

• 如果未安装 Claude Code 或 Codex，PhpStorm 不会在 AI 代理 下拉菜单中显示它们。

开始新的 SSH 会话

1. 在终端工具栏中点击 并选择 新建 SSH 会话。

   

2. 输入要连接的主机地址并提供身份验证信息。

   

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

要终止连接，请在终端选项卡中点击 。

重命名终端标签页

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

在终端中搜索

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

默认情况下，搜索不区分大小写。 默认情况下，搜索不区分大小写。您可以点击搜索字段中的 （区分大小写 ）启用大小写敏感。

从终端导航到文件和文件夹。

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

• 按住 Ctrl 并点击终端中的文件名，即可在编辑器中打开该文件。

• 按住 Ctrl 并点击终端中带有文件夹名的链接，即可在 Project 工具窗口中定位该文件夹。 如果文件夹不在当前项目中，PhpStorm 将会打开默认的文件系统资源管理器。

• 或者，点击文件或文件夹名称，然后在工具提示中使用 打开 链接。

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

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

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

  当 将文件上下文发送给 CLI 编码代理或运行以路径为实参的命令时，这会很有用。

• 将文件或文件夹拖到终端标签区域（2），即可打开一个新标签页，工作目录会设置为所拖文件夹，或为所拖文件的父文件夹。

在终端中使用补全

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

当您键入时，建议会自动显示在 终端 工具窗口中。 默认情况下，PhpStorm 会显示参数的建议。

• 要启用对子命令、参数和实参的补全，请转到 设置 | 工具 | 终端 | 命令补全 ，并为 在键入时显示补全弹出窗口 选项选择 始终。

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

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

配置终端仿真器

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

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

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

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

为了更清晰地区分命令的起始位置，您可以在终端中启用分隔符。

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

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

   

   

3. 请点击 Apply 以保存更改。