企业官网建设流程全解析

• CLI
• 开发工具

本文以 fish-shell 仓库中 fish_greeting 命令文档 为核心，系统讲解 fish 交互式 Shell 的欢迎语机制：默认函数如何工作、如何通过变量或函数自定义欢迎语、如何在config.fish中禁用、以及如何与 systemdrun0引入的SHELL_WELCOME标准环境变量协同。读完本文，你将掌握欢迎语从“改文字”到“彻底重写”的完整实战方案，并理解其“只在交互式 Shell 中执行”的底层设计原理。

一、fish_greeting 是什么：一个函数，而非一个固定字符串

fish_greeting是 fish 在进入交互式模式时执行的一个函数，它的标准输出会被显示在终端上，作为 Shell 启动后的第一段欢迎信息。其核心设计是**“函数与同名变量解耦”**：默认的fish_greeting函数只是一个读取同名变量$fish_greeting并打印的“壳”，因此：

• 只想改欢迎文字，改变量即可；
• 想完全重写欢迎逻辑（比如随机显示、带上系统信息），直接重定义函数即可。

从源码看，默认函数定义在 share/functions/fish_greeting.fish 中，全文仅 17 行，逻辑非常清晰：

function fish_greeting if not set -q fish_greeting set -l line1 (_ 'Welcome to fish, the friendly interactive shell') set -l line2 \n(printf (_ 'Type %shelp%s for instructions on how to use fish') (set_color green) (set_color --reset)) set -g fish_greeting "$line1$line2" end if set -q fish_private_mode && set -q fish_greeting[1] set -l line (_ "fish is running in private mode, history will not be persisted.") set -g fish_greeting $fish_greeting\n$line end # The greeting used to be skipped when fish_greeting was empty (not just undefined) # Keep it that way to not print superfluous newlines on old configuration test -n "$fish_greeting" and echo $fish_greeting end

逐段解读这段默认实现：

1. 首次运行生成默认文字：当$fish_greeting变量未定义时，用本地化文本（_是 fish 的 gettext 翻译辅助函数）拼接两行内容——第一行是 “Welcome to fish, the friendly interactive shell”，第二行是用绿色高亮help一词的引导提示（set_color green与set_color --reset包裹命令名）。注意这里用的是set -g（全局作用域），意味着默认欢迎语不再以通用变量（universal variable）形式写入所有会话，这也是 CHANGELOG 中记录的 3.0 时代设计变更（CHANGELOG.rst 第 2232 行附近：fish_greeting由通用变量改为函数，避免默认污染所有用户配置）。
2. 私有模式追加提示：当fish_private_mode被设置（例如以fish --private启动）时，会在欢迎语末尾追加一行 “fish is running in private mode, history will not be persisted.”，提醒当前会话不会持久化历史记录。这一点在 CHANGELOG 中也有对应记录（第 1959 行：即使$fish_greeting为空列表也会在私有模式打印提示）。
3. 空值即静默：test -n "$fish_greeting"保证当变量为空时不做任何输出，避免老配置产生多余的换行。这正是“禁用欢迎语”功能能生效的底层原因。

二、调用时机：为什么它只在交互式 Shell 中出现

fish_greeting并不是在config.fish加载时执行的，而是挂在 fish 的交互式初始化链路上。调用链在 share/config.fish 与 share/functions/__fish_config_interactive.fish 中清晰可见：

1. share/config.fish 第 117-122 行定义事件处理器__fish_on_interactive，它同时监听fish_prompt与fish_read两个事件，触发后先自我删除（functions -e __fish_on_interactive，注释明确指出这是为了防止fish_greeting内部调用read造成无限循环），再调用__fish_config_interactive。
2. share/functions/__fish_config_interactive.fish 第 32-35 行执行真正的欢迎逻辑：

if not status is-interactive-read and functions -q fish_greeting fish_greeting end

这里的关键点是status is-interactive-read检查——它确保在脚本化的read（如scp之类工具会通过执行一个 shell 来读取数据）场景下不会打印欢迎语，这正是原文档强调的“防止某些错误”的源码实现依据。fish 社区为此专门修复了 #7080 问题（欢迎语在脚本read时被误打印）。

紧接着第 37-42 行处理SHELL_WELCOME环境变量（详见下文第四节）。

如果你希望跳过所有交互式初始化，可以在启动时使用fish --no-config或非交互式调用（如fish -c），这些场景都不会触发欢迎语。

三、自定义欢迎语：三种由浅入深的做法

原文档给出了三种不同粒度的自定义方式，这里结合仓库文档 doc_src/interactive.rst（第 257-274 行的 “Configurable greeting” 一节）与 share/completions/set.fish（第 69 行对fish_greeting变量补全描述为 “The message to display at start (also a function)”）展开说明。

方式一：只改文字（推荐，改动最小）

默认函数会打印$fish_greeting变量，因此直接给变量赋值即可：

# 全局作用域，写入 config.fish 中 set -g fish_greeting 'Hey, stranger!'

如果想在所有 fish 会话（包括未来的新会话）中都生效，用通用变量：

set -U fish_greeting 'Hello from my machine!'

还可以在欢迎语中嵌入命令替换与颜色：

set -g fish_greeting "It's (date +%T) on $hostname, nice to see you!"

方式二：重写函数（灵活，可编程）

当欢迎逻辑不再是“一行静态文本”时，直接定义你自己的fish_greeting函数。原文档给出的示例融合了set_color与date：

function fish_greeting echo Hello friend! echo The time is (set_color yellow)(date +%T)(set_color --reset) and this machine is called $hostname end

doc_src/interactive.rst 中还有一个更活泼的随机问候版本：

function fish_greeting random choice "Hello!" "Hi" "G'day" "Howdy" end

由于 fish 支持函数自动加载（autoloading），你可以把自定义函数保存为~/.config/fish/functions/fish_greeting.fish，它会自动覆盖默认实现；也可以把它直接写进config.fish。更省事的编辑方式是用funced fish_greeting就地编辑、funcsave fish_greeting保存（对应命令文档见 funced.rst 与 funcsave.rst）。fish_delta命令可以对比你的自定义函数与默认版本之间的差异，测试 tests/checks/fish_delta.fish 中专门覆盖了这一场景（对fish_greeting.fish打上# Modified标记后，期望fish_delta输出 diff 结果）。

方式三：两者结合——用变量控制逻辑

重写的函数内部依然可以读取同名变量$fish_greeting，实现“逻辑在函数、文案在变量”的灵活拆分，例如只在变量非空时才打印附加信息。

四、禁用欢迎语：两种等价写法

原文档给出了两种禁用方式，注意它们的适用范围不同：

# 方式 A：通用变量置空（影响所有会话，持久生效） set -U fish_greeting # 方式 B：全局变量置空（写在 config.fish 中，本会话生效） set -g fish_greeting

两种写法都等价于“把$fish_greeting设为空列表”，配合默认函数末尾的test -n "$fish_greeting"判断，最终不会输出任何内容。

这里有一个历史兼容性陷阱值得注意：在 fish 3.0 之前，fish_greeting默认是一个通用变量，用户只需在交互式会话里执行set fish_greeting（不加作用域前缀）就能永久禁用；3.0 改为“函数 + 默认全局变量”后，交互式执行set fish_greeting只会产生一个局部变量，必须显式set -U（通用）或写进 config.fish 用set -g（全局）才能禁用。CHANGELOG 第 2469-2470 行明确记录了这一破坏性变更及其正确用法，写配置时务必区分。

五、SHELL_WELCOME：兼容 systemd run0 的标准欢迎通道

SHELL_WELCOME是原文档重点介绍的标准环境变量，fish 在欢迎语之后、如果检测到它已设置，会将其内容原样显示。仓库源码 share/functions/__fish_config_interactive.fish 第 37-42 行：

# Display SHELL_WELCOME if set. This is a standard environment variable (introduced by # systemd v257) intended for shells to display when they first initialize. if not status is-interactive-read and set -q SHELL_WELCOME[1] string join -- ' ' $SHELL_WELCOME end

实现要点：

• 来源：该变量由 systemd v257 引入，像systemd-run --shell/run0这类工具会设置它，用于向用户展示会话信息（例如以哪个用户、哪个安全上下文运行）。
• 语义：显示在fish_greeting之后，同样受status is-interactive-read保护，脚本化的read场景不会误输出。
• 处理方式：SHELL_WELCOME可能包含多个元素（数组），string join -- ' '将其用空格拼接后打印，保持一行输出。
• 测试佐证：集成测试 tests/checks/tmux-read.fish 第 23-30 行验证了SHELL_WELCOME=hello fish -ic "read --prompt-str=R"场景下不会在read提示符前多打印欢迎内容，同时tmux会话中echo foo与hello name等问候输出顺序被严格断言。
• 配套机制：CHANGELOG 第 209 行记录了 fish 同时支持SHELL_PROMPT_PREFIX、SHELL_PROMPT_SUFFIX两个配套标准变量（分别自动拼接到左侧提示符前后），与SHELL_WELCOME构成完整的 systemd 会话信息接入方案。

如果你想验证SHELL_WELCOME的显示效果，可以临时设置后启动交互式会话：

SHELL_WELCOME="Session opened as $USER" fish

六、为什么不建议用 echo 直接写在 config.fish 里

原文档明确给出了一个反模式对比：在config.fish里写echo虽然“也能显示欢迎信息”，但存在严重的适用范围问题。原因是config.fish在 fish 启动时必然加载，包括以下非交互场景：

• scp等远程工具会通过执行一个 shell（如scp file user@host:.触发远端 shell）来读写数据；
• fish -c "command"等一次性执行；
• 其他将 fish 作为解释器调用的场景。

在这些场景下，config.fish中的echo会把欢迎文本混入程序输出，轻则污染 stdout，重则导致协议解析失败。而fish_greeting只在交互式模式（且非is-interactive-read）下被调用，天然规避了这一问题——这正是设计上把欢迎语“函数化”而非“配置脚本化”的根本原因。

七、FAQ 与常见坑

Q1：为什么我在交互式会话里执行set fish_greeting后，下次启动欢迎语还在？因为没有指定作用域，set默认设置的是局部/全局一次性变量，会话结束后即消失。持久禁用请用set -U fish_greeting（通用变量）或写入 config.fish 用set -g fish_greeting。

Q2：欢迎语里能否调用read做交互输入？可以，但 fish 的初始化链路专门做了防递归处理：__fish_on_interactive在调用__fish_config_interactive之前先删除自身，避免fish_greeting内部的read再次触发fish_read事件造成无限循环（share/config.fish 第 118-120 行注释）。测试 tests/checks/tmux-read.fish 第 5-19 行验证了“欢迎语中 read 输入名字并回显”的完整流程。

Q3：如何同时保留默认欢迎语和我自己的附加内容？在自定义函数中先调用默认逻辑再追加，或直接读取/拼接$fish_greeting变量，例如：

function fish_greeting set -g fish_greeting (set -q fish_greeting; and echo $fish_greeting; or echo "")"$line1$line2" echo $fish_greeting echo "Today is (date +%F)" end

Q4：fish --private模式下欢迎语有什么特殊表现？默认函数会在fish_private_mode开启时自动追加一行“历史不会持久化”的提示（share/functions/fish_greeting.fish 第 8-11 行），即使你的$fish_greeting为空也会尝试提示。

Q5：怎么检查我的自定义欢迎函数有没有生效？用functions fish_greeting查看当前生效的定义；用fish_delta对比与默认版本的差异（参考 tests/checks/fish_delta.fish 第 16-21 行的断言）；或直接新开一个交互式终端观察输出。

八、延伸阅读

• 欢迎语在交互式启动流程中的完整位置：share/functions/__fish_config_interactive.fish 与 share/config.fish
• 交互式会话自定义总览（问候语、标题栏、提示符）：doc_src/interactive.rst
• SHELL_WELCOME环境变量的语法定义：doc_src/language.rst
• set命令的通用/全局作用域说明：set.rst；函数编辑工具：funced.rst、funcsave.rst
• 欢迎语与私有模式的历史变更记录：CHANGELOG.rst

• CLI
• 开发工具