企业官网建设流程全解析

• CLI
• 开发工具

prompt_login是 fish-shell 内置的一个提示符辅助函数，用于在交互式提示符（prompt）中描述当前登录状态：显示当前用户名、主机名，并自动标识 shell 是否运行在 chroot 环境中（当前支持读取 Debian 系的debian_chroot文件）。本文以 doc_src/cmds/prompt_login.rst 文档为主体，结合 share/functions/prompt_login.fish 源码实现，讲解其输出行为、配色机制与自定义 fish_prompt 的实战方法。

函数定位：提示符中的“登录信息”组件

fish 的提示符不像其他 shell 那样由固定的 PS1 模板决定，而是通过运行一个函数来构建——即fish_prompt函数，它打印什么，终端就显示什么（见 Writing your own prompt）。为了让用户快速、一致地写出信息丰富的提示符，fish 提供了一组现成的辅助函数，其中：

• prompt_login：描述当前登录，输出用户@主机，并附带 chroot 环境提示（见 doc_src/cmds/prompt_login.rst）；
• prompt_hostname：只输出主机名；
• prompt_pwd：输出缩短后的当前工作目录；
• fish_is_root_user：判断当前是否为 root 用户，供提示符切换符号或颜色；
• fish_vcs_prompt：显示版本控制信息。

从 CHANGELOG.rst 的记载看，prompt_login是一个后来引入的辅助函数，用于在提示符中描述“登录类型”（用户、主机与 chroot 状态），取代了旧的 “debian chroot” 提示实现，并已集成进默认提示符与 terlar 提示符。

语法与基本调用

prompt_login不需要任何参数：

prompt_login

它把结果直接打印到标准输出（不带换行），因此典型用法是放在fish_prompt中与其他组件拼接。原文档给出了最简示例：

function fish_prompt echo -n (prompt_login) (prompt_pwd) '$ ' end

运行效果（假设用户为 root、主机名为 bananablaster）：

>_ prompt_login root@bananablaster

echo -n用于抑制换行，(prompt_login)是命令替换，将其输出内联进提示符字符串，后面再接prompt_pwd输出的缩短路径与提示符结束符。

输出内容拆解：用户、主机与 chroot

prompt_login的输出由三部分组成，对应三个维度的登录信息：

1. 用户名：来自 fish 内建变量$USER，以fish_color_user颜色渲染；
2. 主机名：来自prompt_hostname（即$hostname去掉第一个.之后的后缀），以fish_color_host颜色渲染，两者之间用@连接；
3. chroot 环境标记：若检测到 chroot，会在最前面额外打印形如(chroot:xxx)的黄色标记。

以源码 share/functions/prompt_login.fish 中的输出语句为证：

echo -n -s (set_color $fish_color_user) "$USER" (set_color --reset) @ (set_color $color_host) (prompt_hostname) (set_color --reset)

即完整输出为用户@主机，其中用户名与主机名分别着色，@不带颜色。

chroot 检测：debian_chroot 机制剖析

prompt_login会判断 shell 是否运行在 chroot 环境中。当前支持 Debian 系的debian_chroot机制，其检测流程在 share/functions/prompt_login.fish 中实现：

if not set -q __fish_machine set -g __fish_machine set -l debian_chroot $debian_chroot if test -r /etc/debian_chroot set debian_chroot (command cat /etc/debian_chroot) end if set -q debian_chroot[1] and test -n "$debian_chroot" set -g __fish_machine "(chroot:$debian_chroot)" end end

要点如下：

• 全局缓存__fish_machine：结果被缓存到全局变量__fish_machine中，首次调用后才真正探测。由于提示符每次命令执行后都会重绘，缓存避免了反复读取/etc/debian_chroot的开销；
• 两种取值来源：优先使用环境变量$debian_chroot；若其未定义或为空，则尝试读取/etc/debian_chroot文件（存在且可读时test -r通过才读取，文件内容即 chroot 名称）；
• 拼装格式：当解析出非空 chroot 名称时，__fish_machine被设为(chroot:名称)；
• 输出：若缓存变量非空，则以黄色打印该标记并跟一个空格：

if set -q __fish_machine[1] echo -n -s (set_color yellow) "$__fish_machine" (set_color --reset) ' ' end

因此在 chroot 环境中，提示符会呈现类似(chroot:buildd) root@host的效果，让用户一眼看出当前命令执行环境与宿主机不同。

SSH 与配色：远程主机的颜色区分

登录方式也会影响输出配色。源码 share/functions/prompt_login.fish 通过$SSH_TTY判断当前是否为 SSH 会话：

set -l color_host $fish_color_host if set -q SSH_TTY; and set -q fish_color_host_remote set color_host $fish_color_host_remote end

• 本地会话：主机名使用fish_color_host；
• SSH 远程会话（SSH_TTY已设置）且fish_color_host_remote已定义时：主机名改用fish_color_host_remote，从而在视觉上区分“本机”与“远程机”；
• 用户名始终使用fish_color_user。

这三个颜色变量都属于 fish 的颜色变量体系，可由主题（theme）统一定义。例如 share/themes/none.theme 中定义了：

fish_color_host --reset fish_color_host_remote yellow fish_color_user --reset

而 share/themes/catppuccin-mocha.theme 则给出了更精细的配色（如fish_color_host 89b4fa、fish_color_host_remote a6e3a1、fish_color_user 94e2d5）。你也可以在~/.config/fish/config.fish中用set -g fish_color_user ...等方式自定义，或用fish_config交互式调整。

实战：把 prompt_login 集成进自定义提示符

原文档的核心示例是把prompt_login与prompt_pwd组合。下面给出一个可复制的完整fish_prompt，覆盖用户、主机、目录、git 状态与退出码等常见要素：

function fish_prompt set -l last_status $status echo -n -s (prompt_login) ' ' (set_color $fish_color_cwd) (prompt_pwd) (set_color --reset) echo -n -s ' ' (fish_vcs_prompt) ' ' if test $last_status -ne 0 set_color red echo -n "[$last_status]" set_color --reset end echo -n '$ ' end

保存到~/.config/fish/functions/fish_prompt.fish后即可生效；也可以先用funced fish_prompt交互编辑，满意后用funcsave fish_prompt落盘（相关用法参见 doc_src/cmds/funcsave.rst）。

在默认提示符中的实际位置

值得参考的是，fish 自带的默认提示符正是以prompt_login打头的。见 share/functions/fish_prompt.fish：

echo -n -s (prompt_login)' ' (set_color $color_cwd) (prompt_pwd) $normal (fish_vcs_prompt) $normal " "$prompt_status $suffix " "

也就是说，开箱即用的默认提示符结构为：登录信息(用户@主机)→ 缩短路径 → git 状态 → 管道状态 → 结束符。同一结构也出现在 share/prompts/default.fish 与 share/prompts/astronaut.fish 中；而 share/prompts/terlar.fish 则直接用prompt_login作为提示符首行。想体验这些内置提示符，可以运行：

fish_config prompt show # 列出全部示例提示符 fish_config prompt choose terlar # 为当前会话选用 terlar

与相关辅助函数的分工

• 只想要主机名：用prompt_hostname，其实现见 share/functions/prompt_hostname.fish，本质是string replace -r -- "\..*" "" $hostname，即截取主机名的第一个点之前部分；
• root 场景：prompt_login会显示真实用户名，若想在 root 时切换提示符符号（如#），可配合fish_is_root_user（见 share/functions/fish_is_root_user.fish），这也是默认提示符的做法。

小结

prompt_login是一个小而实用的提示符组件：它一次调用即可输出“用户名 + 主机名 + chroot 标记 + SSH 远程配色”等登录维度信息，并自带结果缓存与颜色变量支持。掌握了它的输出规则（doc_src/cmds/prompt_login.rst）和实现细节（share/functions/prompt_login.fish）之后，你就可以像 fish 的默认提示符一样，在自定义fish_prompt中灵活复用，并结合prompt_pwd、fish_vcs_prompt、fish_is_root_user等辅助函数搭建出信息完整、观感清爽的提示符。

• CLI
• 开发工具