# fish (简体中文)

From ArchWiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

翻译状态：本文是 Fish 的翻译。上次翻译日期：2021-05-31。如果英文版本有所更改，则您可以帮助同步翻译。

fish是“friendly interactive shell”的缩写，是一个“交互式的、对用户友好的 命令行shell”。

fish 被有意设计成不完全与 POSIX 兼容。fish 的作者们认为 POSIX 中存在一些缺陷和矛盾，并通过 fish 简化的或不同的语法解决这些问题。因此，即使简单的 POSIX 兼容的脚本也可能需要较多的修改──甚至完全重写──才能在 fish 中运行。

## 安装

安装 fish 软件包。或者安装开发版的 fish-gitAUR。

安装完成这后，输入 `fish` 即可进入 fish shell。

要查看帮助文档，在 fish 中输入 `help`，文档将会在浏览器中打开。建议用户至少读完文档中“Syntax overview”这一节内容，因为 fish 的语法和其他 shell 的并不一样。

## 在系统中配置 fish

需要考虑的是：是把 fish 设置为默认 shell，也就是用户登录时直接进入的 shell，还是通过当前的默认 shell 启动 fish，并只在交互模式下使用 fish。这里，我们假设当前的默认 shell 是 Bash。

- 把 fish 设为默认shell：这种方式需要用户对 fish 的运行机制及其脚本语言有些基本的了解。用户需要把当前的初始化脚本和环境变量移动到 fish 的环境中。#将 fish 设为默认 shell 中有具体的步骤。

- 只把 fish 用作交互式shell：这种方法“破坏性”较小。Bash 会照常运行所有的初始化脚本，并在此基础上启动 fish。#仅将 fish 用作交互式 shell 中有具体的步骤。

### 将 fish 设为默认 shell

如果你决定把 fish 设为默认的 shell，首先你需要将你的用户的 shell 改为`/usr/bin/fish`。参照 Command-line shell#Changing your default shell 中的步骤。

下一步是把 Bash 的几个初始化脚本中的操作和配置用 fish 的方法和工具重写，这些脚本分别有`/etc/profile`、`~/.bash_profile`、`/etc/bash.bashrc`和`~/.bashrc`。

需要特别关注的是，在登录到 fish 中后，你需要尽快检查、调整环境变量`$PATH`的内容。在 fish 中，`$PATH`是一个全局环境变量：全局表示作用范围包含所有函数，并且会在重启的时候被清除；环境变量则意味着它对 fish 的所有子进程都是可见的。相较于修改直接修改 `$fish_user_path`，现在更推荐在配置文件中使用 fish_add_path 来设置路径，比如

    $ fish_add_path -p /路径_1 /路径_2 /路径_3

会将这三个路径添加到搜索路径的头部。

### 仅将 fish 用作交互式 shell

如果不将 fish 设为默认 shell，就能照常运行 Bash 的初始化脚本。这能够保证用户当前的环境变量不受影响并且在 fish 中也能使用，因为 fish 是作为 Bash 的子进程运行的。下面是几种只把 fish 用作交互式 shell 的方法。

#### 通过 .bashrc 启动 fish

The factual accuracy of this article or section is disputed.

Reason: 把 `exec fish` 写在 `.bashrc` 中或许不是万全的做法，比如这个 bug 报告：https://bugzilla.redhat.com/show_bug.cgi?id=1910424. (Discuss in Talk:Fish (简体中文)#)

保持默认 shell 为 Bash 不变，然后添加`exec fish`到合适的 Bash 配置文件中，比如`.bashrc`。用这种方法，Bash 会正常执行`/etc/profile`和`/etc/profile.d`中的所有配置文件。相对于后面的几种方法，这种是最通用的，因为这种方法在本机计算机和 SSH 远程计算机上都能使用。

提示：

- 在这种配置下，如要使用 Bash 而不是接着启动 fish，需要使用`bash --norc`，以防止Bash加载`~/.bashrc`之后执行`exec fish`。
- 要让类似于`bash -c 'echo test'`中的命令在 Bash 中执行而不是启动 fish，你可以将`exec fish`换为`if [ -z "$BASH_EXECUTION_STRING" ]; then exec fish; fi`。
- 在父进程不是 fish 的情况下才起动 fish：这种方法可以在更方便地切换到 Bash 的同时继续使用 `~/.bashrc` 中的配置。

      if [[ $(ps --no-header --pid=$PPID --format=cmd) != "fish" ]]
      then
          exec fish
      fi

#### 使用终端模拟器的选项

另一种方法是在启动终端模拟器时通过添加命令行选项来启动fish。对于大部分的终端，这个选项是 `-e`。比如，要打开 gnome-terminal 并运行fish，可以将 gnome-terminal 的快捷方式改为：

    gnome-terminal -e fish

对于不支持设置 shell 的终端模拟器，比如lilyterm-gitAUR，则需要这样：

    SHELL=/usr/bin/fish lilyterm

另外，有些终端可以在设置或配置文件中将 fish 设为默认 shell。

#### 使用终端复用器的选项

要将 fish 设为 tmux 启动的默认 shell，在`~/.tmux.conf`中加入这行：

    set-option -g default-shell "/usr/bin/fish"

当 tmux 启动时，就会自动进入 fish。

## 配置

fish的配置脚本保存在`~/.config/fish/config.fish`。这个文件与 `.bashrc`相似，当每次启动时，fish会执行这个文件中的命令。需要注意的是，如果需要设置长期保留的变量，应该将这个变量设为一个全局变量，而不是将它定义在这些配置脚本中。

用户定义的函数保存在`~/.config/fish/functions`中，文件名为`函数名.fish`。

### 网页界面

可以在 fish 的交互式网页配置页面中修改配色、提示符、函数、变量、历史记录和快捷键：

    $ fish_config

在 IPv6 被完全禁止的环境下，网页配置界面或许不能起动。参见[1] 和 IPv6#Disable IPv6。

### 命令补全

fish 可以通过解析 man 的数据生成自动补全规则，这些自动补全规则被保存在`~/.config/fish/generated_completions/`。可以运行下面的命令自动更新补齐规则。

    $ fish_update_completions

你也可以在 `~/.config/fish/completions/` 目录下放置自己定义的补全规则。`/usr/share/fish/completions/` 中有更多的例子。

对 Arch Linux 来说， pacman, pacman-key, makepkg, cower, pbget, pacmatic 这些命令的自动补全规则已经在内置在 fish 中了，因为 fish 在开发的时候就包含了很多命令的补全规则。fish 的内存管理足够智能，不会因为命令补全产生负面影响。

## 提示与技巧

### 命令替换

fish 没有 Bash 式的历史记录替换功能（如 `sudo !!`）。fish 的开发者在 fish faq 中建议使用交互式的方式调用历史记录：`上`方向键可以按整条命令回顾历史，而`Alt+上`可以回顾命令的单个参数。`Alt+S` 会在整条命令的最前面加上 `sudo`。

不过，fish wiki 中介绍了一些替代方法。虽然这些方法提供的历史替换功能并不完整，但可用的有 `!!`（替换上一条命令）和 `!$`（替换上一条命令的最后一个参数）。

### 串联命令

在低于 3.0 的版本中，fish 并未实现串联命令符号 `&&` 和 `||`，推荐使用 `; and` 和 `; or` 语法来实现相似的效果。也可以参照 fish wiki，设置按键绑定来自动替换符号。

### 取消问候语

默认情况下，每次启动时 fish 都会打印问候语。如要不显示问候语，可以在 fish 中运行：

    set -U fish_greeting ""

### 让 su 默认启动 fish

如果 su 目标用户的默认 shell 是 Bash，但是你想使用 fish 作为 shell 的话，可以添加一个 `su` 函数覆盖默认的 su 命令，在切换用户的时候自动使用 fish：

    function su
        /bin/su --shell=/usr/bin/fish $argv
    end

### 登录 fish 时自动起动 X

把下面配置添加到 `~/.config/fish/config.fish`，即可在登录 tty1 的时候自动启动 X。

    # Start X at login
    if status --is-login
        if test -z "$DISPLAY" -a $XDG_VTNR = 1
            exec startx -- -keeptty
        end
    end

如果在使用 fish 作为交互 shell，需要把例子中的 `is-login` 换为 `is-interactive`。

### 在提示符中增加 git 状态

当你处在一个 git 目录中时，如果你想在 fish 的提示符中显示分支和修改的相关信息，可以仿照以下的例子编写 `fish_prompt` 函数：

    ~/.config/fish/functions/fish_prompt.fish

    function fish_prompt
      set -l last_status $status

      if not set -q __fish_git_prompt_show_informative_status
        set -g __fish_git_prompt_show_informative_status 1
      end
      if not set -q __fish_git_prompt_color_branch
        set -g __fish_git_prompt_color_branch brmagenta
      end
      if not set -q __fish_git_prompt_showupstream
        set -g __fish_git_prompt_showupstream "informative"
      end
      if not set -q __fish_git_prompt_showdirtystate
        set -g __fish_git_prompt_showdirtystate "yes"
      end
      if not set -q __fish_git_prompt_color_stagedstate
        set -g __fish_git_prompt_color_stagedstate yellow
      end
      if not set -q __fish_git_prompt_color_invalidstate
        set -g __fish_git_prompt_color_invalidstate red
      end
      if not set -q __fish_git_prompt_color_cleanstate
        set -g __fish_git_prompt_color_cleanstate brgreen
      end

      printf '%s%s %s%s%s%s ' (set_color $fish_color_host) (prompt_hostname) (set_color $fish_color_cwd) (prompt_pwd) (set_color normal) (__fish_git_prompt)

      if not test $last_status -eq 0
        set_color $fish_color_error
      end
      echo -n '$ '
      set_color normal
    end

然而，fish 已经抛弃了这种方式，参见 fish-shell git。作为替代，fish 现在内置了Informative Git Prompt，该功能可以通过 `fish_config` 启用。

### 在 SSH 中用彩色显示主机名

如果需要在通过 SSH 登录到 fish 时用不同的颜色标记提示符中的主机名，可以将以下内容添加到函数 `fish_prompt` 中，或者添加到 fish 的配置文件中。这里以红色为例：

    ~/.config/fish/functions/fish_prompt.fish

    ...
    if set -q SSH_TTY
      set -g fish_color_host brred
    end
    ...

### ssh-agent 问题

在fish中，`eval (ssh-agent)` 会因为变量的设置方式而报错。一个变通的方案是使用 csh 风格的选项`-c`：

    $ eval (ssh-agent -c)

### "command not found" 事件函数

fish 包含了一个响应“命令未找到”（"command not found"）事件的函数 `fish_command_not_found`。当遇到一个当前系统不存在的命令时，这个函数会使用 pkgfile 在官方仓库中查找哪个软件包拥有这条命令，而如果 pkgfile 不存在则回落使用 `pacman -F` 作为替代。

从 fish 3.2.2 开始，因为 `pacman -F` 严重的卡顿问题，所以 `fish_command_not_found` 不会再使用它作为回落。

可以写一个 `fish_command_not_found` 函数来替换掉 fish 自带的。比如在“命令未找到”时只打印错误消息，这样就不会有卡顿现象：

    $ function fish_command_not_found
          __fish_default_command_not_found_handler $argv[1]
      end

然后保存这个函数：

    $ funcsave fish_command_not_found

### 从 jobs 中删除进程

当退出 fish 的时候，所有后台进程也会终止。为了让一个任务即使在 fish 退出了之后也继续运行，需要先输入 `disown` 命令再退出。比如说，这个例子在后台起动 Firefox 然后 `disown` 它：

    $ firefox &
    $ disown
    $ exit

这样即使退出了 fish，Firefox 也会继续运行。请查阅 fish 的 disown(1) 了解更多细节。

### 快速设置别名

如果想要快速设置一个持久化的别名（即使 fish 退出也不会失效），可以使用这种方法：

    $ alias FooAliasName "foo --option"
    $ funcsave FooAliasName

而在 fish 3.0 之后的版本中，`alias` 增加了 `--save(-s)` 选项。

    $ alias -s FooAliasName "foo --option"

别名会自动保存，这样就不需要再执行 `funcsave`。如果想查看或者编辑所有的函数，可以运行 `fish_config`，然后在网页界面的 Function 标签下进行配置。

如要获取更多文档，查阅 alias - create a function — fish-shell。

## 另请参阅

- https://fishshell.com/ - 主页
- https://fishshell.com/docs/current/ - 文档
- https://hyperpolyglot.org/unix-shells - Shell 语法对照表（Shell 的“罗塞塔石碑“）
- https://github.com/fish-shell/fish-shell - fish 的 GitHub 仓库

Category:

- Command-line shells (简体中文)

Hidden category:

- Pages or sections flagged with Template:Accuracy