Fish Shell 4.0.0 版本输出重定向问题分析与解决方案

在 Fish Shell 4.0.0 版本中，用户报告了一个关于脚本输出重定向的异常行为。当用户将 Fish 脚本的输出重定向到文件时，文件中会意外出现额外的控制字符。这些字符实际上是终端光标形状控制序列，它们不应该出现在非交互式脚本的输出中。

问题现象

用户发现，在 Fish Shell 4.0.0 中，当执行以下简单脚本并重定向输出时：

#!/usr/bin/env fish
echo hello

重定向到文件后，文件开头和结尾会分别多出五个字节的额外内容。通过十六进制分析，这些字节分别是：

文件开头添加的字节：

1B 5B 36 20 71

文件结尾添加的字节：

1B 5B 32 20 71

这些字节序列实际上是 ANSI 转义码，转换为可读形式分别是 ^[[6 q 和 ^[[2 q，这是用于控制终端光标形状的指令。

问题根源

经过深入分析，这个问题源于 Fish Shell 4.0.0 版本中的一个回归错误。具体来说，fish_vi_key_bindings 函数被错误地在非交互式 shell 中执行，导致这些本应只在交互式终端中使用的光标控制序列被输出到了重定向的文件中。

在正常的交互式 shell 中，这些光标控制序列是有意义的，它们可以改变光标的外观（如块状、下划线状等），特别是在使用 vi 模式的键绑定时。然而，在非交互式脚本执行环境中，这些控制序列不应该被输出，特别是当脚本的输出被重定向到文件时。

解决方案

Fish Shell 开发团队已经修复了这个问题（提交 044afefc5c78998458b55f9264f5a63ffce1cc4f）。对于暂时无法升级到修复版本的用户，可以采用以下临时解决方案：

在用户的 config.fish 配置文件中，确保 fish_vi_key_bindings 只在交互式 shell 中执行：

status is-interactive || exit
fish_vi_key_bindings

这段代码首先检查当前 shell 是否为交互式 shell，如果不是则退出，从而避免在非交互式环境中执行可能导致问题的键绑定设置。

技术背景

终端控制序列（ANSI 转义码）是用于控制终端行为和外观的特殊字符序列。以 ESC [ 开头（十六进制 1B 5B）的序列通常用于控制光标位置、颜色、样式等。在这个问题中出现的序列：

• ESC [ 6 q：将光标设置为竖线形状
• ESC [ 2 q：将光标设置为块状

这些序列在交互式终端中有实际效果，但当被写入普通文件时，它们会成为文件内容的一部分，可能导致后续处理这些文件时出现问题。

最佳实践

对于 shell 脚本开发者，特别是使用 Fish Shell 的用户，建议：

1. 在编写将被重定向输出的脚本时，注意检查脚本中是否包含可能输出终端控制序列的函数或命令
2. 对于配置文件中可能影响非交互式 shell 的设置，使用 status is-interactive 进行保护
3. 定期更新 shell 版本以获取最新的错误修复和安全更新

这个问题也提醒我们，在开发 shell 脚本和配置时，需要明确区分交互式和非交互式使用场景，确保功能在不同环境下都能正常工作。