Fish shell 速查表

本文根据 Devhints / Fish shell 翻译。代码示例及版本范围沿用原文。原文标注更新日期：2018-01-31。

按键

示例程序

#!/usr/bin/env fish

echo 'Hello from Fish!'

注释

# my comment

打印

echo 'Hello from Fish!'
# or
printf '%s\n' 'Hello from Fish!'

打印字符串（末尾附带内容） \n.

从标准输入（stdin）读取

read my_variable

将字符串读入变量 my_variable.

循环

for i in (seq 1 10)
  ...
end

变量

定义与清除

# Declare the global/local variable:
set my_variable 'Hello from Fish!'

i# Remove the variable:
set --erase my_variable

切片

echo $my_variable[1..10]
echo $my_variable[2..]
echo $my_variable[..-2]

数字

递增与递减

set my_variable (math $my_variable + 1)
set my_variable (math $my_variable - 1)

算术运算

echo (math 1 + 2)

字符串

匹配

将字符串与正则表达式进行匹配：

string match --regex --entire 'Fish' 'Hello from Fish!'

此处介绍的是与 Perl 兼容的正则表达式。

替换

# Replaces the first match
string replace --regex 'Fish' 'fish' 'Hello from Fish!'

# Replaces all matches
string replace --regex --all 'Fish' 'fish' 'Hello from Fish!'

条件判断

If/else

if test $my_variable -lt $another_variable
  ···
else if test $my_variable -eq $another_variable
  ···
else
  ···
end

比较

数字

字符串

文件

进程通信

写入文件

# Overwrite file
echo 'Hello from Fish!' > my_file

# Append to file
echo 'Hello from Fish!' >> my_file

管道 (Piping)

my_command | another_command

将第一个命令的标准输出（stdout）作为输入传递给第二个命令。

命令替换

echo (math $my_variable + 1)

该 (...) 表达式被替换为其内部命令的输出结果。

进程替换

echo (math $my_variable + 1 | psub)

该 (... | psub) 表达式被替换为一个包含命令输出结果的临时文件。

函数

定义与清除

# Declare the function
function my_function --description 'My description'
  ···
end

# Remove the function
functions --erase my_function

事件

触发（发送）

emit my_event

触发一个可被其他函数捕获的事件。

事件处理

function my_hook --on-event my_event
  ···
end

响应 my_event 事件。

缩写

定义与清除

# Declare the abbreviation
abbr --add grh "git reset --hard HEAD"

# Remove the abbreviation
abbr --erase grh

补全

定义补全

complete --command mycommand --arguments 'install uninstall'
complete --command mycommand --short-option 'h' --long-option 'help' --description 'Display help'

声明命令的补全规则。

移除补全规则

complete --command mycommand --erase

实用的内置函数