Pebrel 文档

文档 / 日常终端

Shell 与启动目录

选择默认 Shell,设定启动目录,添加带参数的启动入口。

为新终端选择 Shell

按 Ctrl+K(macOS 为 ⌘K)打开 Shell 选择器,选择要启动的终端程序。列表取决于当前电脑已安装的 Shell,以及你配置的启动入口。

Windows 可以使用 PowerShell、命令提示符以及已安装的 WSL 发行版。macOS 和 Linux 使用系统中可用的 Shell;安装了 Zellij 时,它也会出现在选择器中,包括 Homebrew 等常见位置。选择一个入口后,Pebrel 会为它建立终端会话。

更改默认 Shell

  1. 打开 设置 → 终端。
  2. 在 默认 Shell中选择常用的程序。
  3. 新建终端,检查提示符是否来自所选 Shell。

已打开的 Shell 会继续运行。更改默认项不会中途替换它们。

找不到刚安装的 Shell 时,先确认该程序可以独立启动,再重新打开 Pebrel。便携终端可以通过设置中的终端目录选择入口添加;应选择包含可执行文件的目录,或其上一级安装目录。

设定启动目录

  1. 打开 设置 → 终端 → 启动,找到 启动目录。
  2. 点击当前路径或“继承当前目录”,在文件夹选择窗口中选取项目目录。
  3. 新建终端,检查是否进入所选目录。

要取消固定启动目录,点击路径右侧的 清除。该项会重新显示“继承当前目录”,新会话可沿用已有终端的已知目录。

在 Windows 上,同一分组还有 新建终端时刷新系统环境变量。开启时,打开终端会读取 Windows 当前的环境设置,刚装好的程序和新改的 PATH 不必重启 Pebrel 就能用;关闭后新终端继承启动 Pebrel 时的环境,包括临时加进去的 PATH。已经打开的终端不受影响。

输入 pwd 查看实际目录;cmd 使用 cd。如果 Shell 自己的启动脚本也执行了 cd,最终目录会受该脚本影响。

配置带参数的启动入口

正式 GPUI 的 Shell 选择器使用自己的终端 Profile 数据。请通过设置中的启动入口配置程序与参数;不要把 Lua config.profiles 校验通过当作选择器已经导入该入口。

需要连接服务器时,可直接运行外部 ssh,或者使用带主机管理与 SFTP 的内置 SSH 连接。

Shell 打不开时

如果创建标签后立即退出,先从系统终端运行同一程序,检查路径和启动参数。自定义 Profile 中,程序路径放在 command,每个参数分别放进 args,不要把整条命令和所有参数合成程序名。

WSL 发行版入口与 Windows 本地 Shell 的文件路径不同,具体见使用 WSL。

关于本页

内容来自用户指南 PR #291,原始基线 v2.1.1。2026-10-21 核对 GPUI 启动入口的数据来源。

Markdown 原文 ↓发行说明 ↗
核对来源

搜索文档

输入关键词,搜索使用指南。

本地全文搜索 PAGEFIND / 不上传搜索内容