终端提示符

Warp 支持两种提示符类型：Warp 提示符和 Shell 提示符 (PS1)。

选择提示符类型

要切换提示符类型

1. 打开 Settings（设置）> Appearance（外观）。
2. 在 Input（输入）下，将 Input type（输入类型）设置为 Warp 或 Shell (PS1)。

当使用 Warp 提示符时，您可以右键点击提示符区域以复制整个提示符、当前工作目录、当前 git 分支、git 未提交文件计数等。

当使用 Shell 提示符时，您可以右键点击提示符区域以复制整个提示符，或在会话中之前运行的块中选择提示符的任何部分。

Warp 提示符

Warp 拥有一个原生提示符，它显示上下文芯片，展示诸如当前工作目录、git 分支、svn 状态、Kubernetes 上下文、pyenv、日期和时间等信息。当 Input type 设置为 Warp 时，Warp 提示符为默认设置。

要自定义 Warp 提示符显示的上下文芯片

1. 右键点击提示符区域并选择 Edit prompt（编辑提示符）。

通过右键点击进行提示符编辑。

2. 选择 Warp Prompt。
3. 拖放上下文芯片以配置您的提示符显示哪些信息。

Git 和 Subversion

Git 和 Subversion 上下文芯片显示您当前所在的本地分支，以及未提交的已更改文件数量。这包括任何已暂存或未暂存的新文件、修改过的文件和已删除的文件。

Kubernetes

当您使用以下命令之一时，Kubernetes 上下文芯片会显示相关信息

kubectl|helm|kubens|kubectx|oc|istioctl|kogito|k9s|helmfile|flux|fluxctl|stern|kubeseal|skaffold|kubent|kubecolor|cmctl|sparkctl|etcd|fubectl

注意

Warp 尊重 KUBECONFIG 环境变量。如果它不是 ~/.kube/config 的默认路径，请确保将其设置为您首选的配置文件位置。

Shell 提示符 (PS1)

您可以通过配置 PS1 变量或安装受支持的 Shell 提示符插件来使用 Shell 提示符代替 Warp 提示符（请参阅 Shell 提示符兼容性表）。

要启用 Shell 提示符

1. 打开 Settings（设置）> Appearance（外观）。
2. 在 Input（输入）下，将 Input type（输入类型）设置为 Shell (PS1)。
3. 在您的 Shell 的 RC 文件中配置 PS1 变量，或安装受支持的提示符插件。

注意

PS1 是 Shell 用来生成提示符的变量，它代表主提示符字符串（因此得名“PS”）——终端通常在输入新命令之前显示它。

多行和右侧提示符

Shell 提示符在 zsh 和 fish 中支持多行或右侧提示符，但在 bash 中不支持。但是，您不能拥有多行右侧提示符，只能拥有多行左侧提示符。

注意

如果您想在 Shell 提示符中添加新行，请根据您的 Shell 或提示符运行以下命令

# Bash
echo -e '\nPS1="${PS1}"$'\''\\n'\''' >> ~/.bashrc

# Zsh
echo -e '\nPROMPT="${PROMPT}"$'\''\\n'\''' >> ~/.zshrc

# Fish
echo -e '\nfunctions --copy fish_prompt fish_prompt_orig; function fish_prompt; fish_prompt_orig; echo; end' >> ~/.config/fish/config.fish

# Powershell
$rawString = @'
$originalPrompt = Get-Item Function:\prompt
Set-Item -Path Function:\prompt_original -Value $originalPrompt
function prompt {
    "$(& prompt_original)`n"
}
'@
Add-Content -Path $PROFILE -Value "`n$rawString`n"

# Powerlevel10k
p10k configure

# Starship Prompt
echo '[line_break]\ndisabled = false' >> ~/.config/starship.toml

工作原理

Shell 提示符兼容性表

Shell	工具	是否有效？
bash | zsh	PS1	有效
bash | zsh | fish | pwsh	Starship	有效*
bash | zsh | fish | pwsh	oh-my-posh	有效
zsh	Powerlevel10k	有效*
zsh	Spaceship	有效*
zsh	oh-my-zsh	有效
zsh	prezto	有效*
ssh		有效
bash	oh-my-bash	不支持
bash	bash-it	不支持
bash	SBP	不支持
bash	synth-shell-prompt	不支持
bash | zsh	Powerline-shell	不支持
zsh	zplug	不支持
fish	tide	不支持
fish	oh-my-fish	不支持

已知不兼容情况

如果您在使用提示符时遇到问题，请查看下文或我们的 已知问题 以获取更多故障排除步骤。

Starship

Starship 设置

已知某些 ~/.config/starship.toml 设置会导致 Warp 出错。使用 # 或 DEL 处理以下行以解决已知错误

# Get editor completions based on the config schema
'' = 'https://starship.rs/config-schema.json'

# Disables the custom module
[custom]
disabled = false

对于 fish Shell（bash|zsh 可选），通过在您的 ~/.config/starship.toml 中放入以下内容来禁用 Starship 中的多行提示符

[line_break]
disabled = true

您可能还会看到与超时相关的错误。您可以在 ~/.config/starship.toml 中设置 command_timeout 变量来修复此问题。更多信息请参见 starship 文档。

Starship + bash

如果您的 默认 Shell 是 /bin/bash，Starship 提示符可能无法正确渲染。要 绕过 该问题，我们建议您升级 bash，通过 echo $(which bash) 找到路径，然后将该路径放入 Settings（设置）> Features（功能）> Session（会话）> “Startup shell for new sessions”（新会话启动 Shell）。

Starship + zsh

如果您想在 zsh 上恢复 Starship 提示符后的附加行，请将以下内容添加到您的 ~/.zshrc 文件末尾： PROMPT="${PROMPT}"$'\n'

Powerlevel10k

安装 Powerlevel10k (P10k) 提示符时，我们建议您使用 Meslo Nerd Font。

P10K 可能会将箭头分隔符显示为灰色而不是彩色。这些字符的颜色由于 Warp 的最小对比度设置而被渲染为灰色。要 绕过 此问题，请转到 Settings（设置）> Appearance（外观）> Text（文本）> Enforce minimum contrast（强制最小对比度）并将其设置为“Never”。

p10k 中灰色分隔符的示例。

Warp 确实支持 p10k 1.19.0 及更高版本。确保您已安装最新版本，并在安装/更新 p10k 后重启 Warp。然后按 上述 说明启用自定义提示符，它应该可以正常工作。

注意

Warp 仍未完全支持某些 p10k 功能，如瞬态提示符和视觉功能（如渐变）。

注意

请注意，“安装 Powerlevel10k”视频提到了在 Settings（设置）> Features（功能）> Honor users custom prompt (PS1)（启用用户自定义提示符 (PS1)）中启用自定义提示符，但现在它位于 Settings（设置）> Appearance（外观）> Input（输入）> Classic（经典）> Current prompt（当前提示符）> Shell Prompt (PS1) 中。

Spaceship

此提示符可能会导致 Warp 输入编辑器中的预输入出现问题。要 绕过 该问题，请运行 echo "SPACESHIP_PROMPT_ASYNC=FALSE" >>! ~/.zshrc。

Prezto

尽管 Warp 对 prezto 的提示符有支持，但在 .zpreztorc 中启用 prezto 实用程序模块 是不受支持的，就像许多其他不兼容的自动补全 插件一样。

为 Warp 禁用不支持的提示符

我们建议使用 Warp 的默认提示符或安装受支持的工具之一，请参阅 兼容性表。您可以为 Warp 禁用不支持的提示符，如下所示

if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then
##### WHAT YOU WANT TO DISABLE FOR WARP - BELOW

    # Unsupported Custom Prompt Code

##### WHAT YOU WANT TO DISABLE FOR WARP - ABOVE
fi

iTerm2

iTerm2 Shell 集成会破坏 Warp，启用此功能后，您的自定义提示符将无法显示。如果您来自 iTerm2，请检查您的 dotfiles。我们建议为 Warp 禁用此集成，如下所示

if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then
##### WHAT YOU WANT TO DISABLE FOR WARP - BELOW

test -e "${HOME}/.iterm2_shell_integration.zsh" && source "${HOME}/.iterm2_shell_integration.zsh"

##### WHAT YOU WANT TO DISABLE FOR WARP - ABOVE
fi