F+
Fish Guide Pages Terminal-setup 仓库的 Fish 技术选型快捷键总表
Fish Route / Terminal-setup / Static Pages

Fish Terminal Setup 快捷键图鉴

这页不是泛泛的 Fish Cheat Sheet,而是专门按照 Terminal-setup 仓库里的 Fish 路线整理出来的“实装版”速查表。 我把仓库真正接入的组件、仓库直接给出的快捷键、以及我补充核对过的上游默认按键分层标清了。

结论先说在前面:这个方案并没有额外装 fisheroh-my-fish 之类的插件管理器, 它走的是 Fish 原生能力 + fzf/zoxide + 一批 CLI/TUI 工具 的轻量路线。 真正需要背键位的重点是 Fishfzflazygitbtopdelta

Fish 原生补全 / autosuggestion / syntax highlight fzf 键盘集成 zoxide 智能跳转 lazygit / btop / delta Fish abbr 命令缩写

范围判断

用户问的是 “Fish 这个技术选型下所有插件的基础快捷键”。所以我先按仓库实现方式做了三个判断:哪些是 Fish 路线真实接入的组件,哪些组件真的存在键盘快捷键,哪些更适合归到“输入式捷径”。

1. 这不是 Oh My Fish 套餐

本机的 config.fish 只初始化 starshipfnmzoxidefzf,再加一个 set-ssh-key 函数。没有 fisheroh-my-fish 或额外 Fish 插件仓库;另已启用 9 个 Fish abbr(含仓库默认的 cdz)。

仓库直出 零插件管理器

2. 真正需要背键位的组件很集中

键位主要集中在 Fish 原生交互、fzflazygitbtopdelta。像 starshipghosttyfnm 在这个仓库里并没有额外自定义快捷键。

键盘快捷键 非所有组件都有键位

3. zoxide / abbr 更像“输入式快捷入口”

z projzi 这类 zoxide 跳转是本机真实可用的 typed shortcuts。lsezalglazygit 等 9 个 abbr(含 cdz)都已写进本机 config.fish 并生效——现在敲 cd 关键词 也会走 zoxide 按记忆跳转。

命令捷径 Fish abbr

Fish 路线真实接入清单

这一段只回答“它到底装了什么、有没有快捷键”这件事,不把说明文档里顺手提到的工具和真正接入到 Fish 的内容混在一起。

Fish Shell

这套方案的 shell 本体。自动补全、autosuggestion、syntax highlighting 都是 Fish 原生能力,不是额外插件。

有基础键位 上游默认

fzf

仓库显式执行 fzf --fish | source,并设置了 FZF_DEFAULT_COMMANDFZF_CTRL_T_COMMANDFZF_ALT_C_COMMAND

有基础键位 仓库直出

zoxide

本机显式执行 zoxide init fish | source,所以 zzi 跳转可用;并已把 cdabbr -a cd "z" 映射到 zoxide,cd 关键词 即按记忆跳转(真实路径 / .. / - 仍照常)。

命令捷径 仓库直出

Fish Abbreviations

本机已启用 9 个 abbrls / ll / ltezacatbatfindfdgreprgtopbtoplglazygitcdzabbr -l 可见),与仓库默认完全一致。

已启用 9 个 与仓库一致

lazygit / btop / delta

这些不是 Fish 插件,但都属于 Fish 技术选型下实际安装的交互式工具。它们的基础键位值得一起整理成速查表。

有基础键位 上游默认

Ghostty / Starship / fnm

仓库会安装并配置,但在 Fish 路线里没有额外自定义按键。它们更像显示层、提示符和版本管理层。

无额外键位 仓库直出

键盘快捷键总表

这里收的是“真按键”。搜索框会同时匹配组件名、键位和描述。默认展示仓库 Fish 路线里最值得背的快捷键组。

⌥ macOS 提示:这台机器是 Mac,键盘上没有写着 “Alt” 的键。本页凡是写作 Alt 的键位(这是 fzf / Fish 上游文档的叫法),在你的 Mac 上都对应 ⌥ Option 键,下面也已统一标成 。注意 Ghostty 默认不会把 Option 当成 Alt 发送,所以这些 键位要先在 Ghostty 配置里设 macos-option-as-alt = true(本机当前还没有 ~/.config/ghostty 配置)才会真正生效。

Fish 原生交互

这些不是第三方插件,而是 Fish 自带能力。之所以一起放进来,是因为这套技术选型的“Fish 体验”本身就依赖它们。

上游默认 适用于未改绑键位的默认 Fish
键位
Right Ctrl+F
作用 接受当前 autosuggestion
来源 Fish 文档
备注 Fish 会把历史记录、补全和路径建议显示在光标后面。
键位
⌥ Right ⌥ F
作用 只接受建议里的第一个词
来源 Fish 文档
备注 适合慢慢补全很长的命令。
键位
Up Down
作用 按当前输入内容搜索命令历史
来源 Fish 文档
备注 如果命令行为空,就是普通历史浏览;有前缀时会按前缀过滤。
键位
⌥ Up ⌥ Down
作用 按当前 token 搜索历史
来源 Fish 文档
备注 比整行历史搜索更细,适合反复回用某个子命令或路径片段。

fzf 键盘集成

Terminal-setup 里最明确的一组快捷键就是 fzf。仓库 README 直接写了三条主入口,fzf 官方 README 则补齐了 Fish 环境下的二级操作。

仓库直出 上游默认补充
键位
Ctrl+R
作用模糊搜索历史命令并插回命令行
备注这是仓库 README 明确点名的第一条快捷键。
键位
Ctrl+R再次按
作用在“相关性排序 / 时间顺序”之间切换
备注当你记得命令的大概位置时尤其好用。
键位
⌥ R
作用在历史搜索里切换 raw mode
备注raw mode 会更容易看到匹配项周围的上下文。
键位
Ctrl+NCtrl+P
作用在 raw mode 中只在命中的项目之间移动
备注Fish 下的 Ctrl+R 二级导航动作。
键位
Ctrl+/⌥ /
作用切换历史搜索结果自动换行
备注长命令很多时非常实用。
键位
Shift+Delete
作用删除历史搜索中选中的命令
备注这是 Fish shell only 行为。
键位
⌥ Enter
作用重新格式化并插入选中的历史命令
备注Fish shell only 行为。
键位
⌥ T
作用循环切换历史前缀显示方式
备注在时间戳、日期时间、无前缀之间切换。
键位
Ctrl+T
作用模糊查找文件并粘回命令行
备注仓库把后端显式改成了 fd --type f --hidden --follow --exclude .git
键位
⌥ C
作用模糊进入目录
备注仓库把目录列表后端显式改成了 fd --type d --hidden --follow --exclude .git

delta 基础翻页

仓库 README 对 git-delta 的键位只明确提到了最常用的一组,所以这里也只保留最核心的两条。

仓库直出
键位
n
作用跳到下一个文件 diff
备注这是 README 在 delta 说明里唯一明确提到的内置键位。
键位
N
作用跳到上一个文件 diff
备注n 组成最基础的一前一后浏览。

Lazygit 基础上手键位

这里挑的是这套 Fish 路线里最值得先背的一层。它们跨 panel 复用率很高,背下来就足够开始日常 commit、checkout、stash、pull/push。

上游默认
键位
q
作用退出 lazygit
备注如果你配置了切换目录退出逻辑,Shift+Q 可以绕开它。
键位
/
作用搜索或过滤当前视图
备注大多数列表面板都支持。
键位
Esc
作用取消 / 返回上一层
备注在复制 cherry-pick 选择、确认框、详情视图里都很常用。
键位
Space
作用Stage / Checkout / Toggle
备注语义跟 panel 有关,但都是“对当前选中项做主要切换动作”。
键位
Enter
作用确认 / 打开详情 / 进入文件
备注另一个“跨 panel 复用”的万能主键。
键位
pP
作用Pull / Push
备注一个小写拉、一个大写推,最容易记。
键位
zZ
作用Undo / Redo
备注基于 reflog;不包括 working tree 里的普通编辑。
键位
Tab
作用在 staged / unstaged 等视图之间切换
备注在 main panel 和文件相关视图里非常常见。
键位
nN
作用新建分支 / 把未推送 commits 移到新分支
备注N 尤其适合“忘了先切新分支”的补救。
键位
w
作用查看 worktree 相关动作
备注在 branch / commit / stash 等多个视图里可用。

btop 基础导航

这里采用的是 btop 官方 README 里的 help-menu 信息。因为 btop 版本不同,个别细节可能略有变化,所以如果发现不一致,进入 btop 后先按 F1h 看当前版本内置帮助。

上游 help-menu 版本差异需以程序内帮助为准
键位
Escm
作用切换主菜单
备注最核心的入口键。
键位
p
作用循环切换视图 preset
备注适合快速切工作模式。
键位
1234
作用切换 CPU / MEM / NET / PROC box
备注最常用的一组 show/hide 键。
键位
5670
作用显示 / 隐藏 GPU 监控 box
备注这是 README 在 GPU 功能说明里单独补充的键位。
键位
d
作用切换 MEM box 的 disks 视图
备注磁盘视图常用入口。
键位
F2o
作用打开 options
备注如果想调刷新率、图形样式、显示项,从这里进。
键位
F1h
作用打开帮助窗口
备注遇到版本差异时以这里为准。
键位
qCtrl+C
作用退出 btop
备注最稳的是直接记 q
键位
UpDown
作用选择进程
备注最基础的进程浏览键。
键位
Enter
作用查看选中进程的详细信息
备注进入 detail 后,操作会更聚焦到当前进程。
键位
Space
作用在 tree view 中展开 / 折叠选中进程
备注只有开了进程树视图才明显。
键位
PgUpPgDnHomeEnd
作用分页跳转 / 到顶部 / 到底部
备注进程多的时候非常节省时间。
键位
LeftRight
作用切换前一个 / 后一个排序列
备注搭配 r 反向排序一起记最好。
键位
bn
作用切换上一个 / 下一个网络设备
备注看多网卡机器时很好用。
键位
ayz
作用网络图自动缩放 / 同步缩放 / 重置 totals
备注属于网络视图常用三件套。
键位
fDelete
作用进入进程过滤 / 清空过滤
备注要定位某个进程名时最实用。
键位
cre
作用切 per-core CPU / 反向排序 / 进程树视图
备注这是进程分析最常用的一组三连。
键位
Selected tSelected kSelected s
作用对选中进程发送 TERM / KILL / 自定义信号
备注只在有进程被选中时有意义,操作前先确认 PID。
补充:help-menu 里还列了刷新间隔、后台挂起等键位。对多数日常使用来说,上面这组已经覆盖了 90% 的高频动作。

命令型捷径

这部分不是“按键”,但在 Fish 方案里一样值得背,因为仓库是用 abbr 和轻量函数来提速的。实际用起来,它们和快捷键一样高频。

Fish Abbreviations(已启用 9 个)

下面 9 个缩写都已经写进本机 config.fish 并生效(含 cdz)。每个「复制」按钮给的是对应的 abbr -a 整条命令——想增删,或在别的机器上复刻时直接拿来用。

ls 展开为 eza --icons --group-directories-first
ll 展开为 eza -la --icons --group-directories-first
lt 展开为 eza --tree --icons --level=2
cat 展开为 bat
find 展开为 fd
grep 展开为 rg
top 展开为 btop
lg 展开为 lazygit
cd 展开为 z,把目录跳转交给 zoxide(已启用:cd 关键词 走记忆跳转)

zoxide / fnm / SSH 切换

这组不是按键映射,但它们是 Fish 方案里真正提升效率的“输入式快捷入口”。

z proj 按模糊关键字跳到最常用目录;README 例子是 z proj / z doc
zi 调用 zoxide 的交互式目录选择
fnm install --lts 安装最新 LTS Node;Fish 里用 fnm env --use-on-cd --shell fish 接入自动切换
fnm use 22 当前 shell 切到 Node 22;配合 .node-version 可自动切
set-ssh-key my-key-name 清空 agent 并载入指定私钥;仓库在 Fish 配置里内置了这个函数

装了,但不需要背额外快捷键

这些组件确实属于这套 Fish 技术选型,但仓库没有再给它们叠一层额外键位,所以不用硬记“快捷键表”。

Ghostty

仓库给出过主题、字体、字号和窗口 padding 配置,但本机当前还没有 ~/.config/ghostty 配置文件,也没有自定义 Ghostty keybindings。Mac 上若要让本页的 键位生效,需要在这里加 macos-option-as-alt = true

Starship

它负责 prompt 外观,不负责按键交互;这套方案只是把它初始化到 Fish 里。

bat / eza / fd / rg / jq / tldr

它们是命令替代工具,不是 TUI,因此更该记的是命令名或 abbr,而不是按键。

来源与校验路径

这页不是凭常识瞎写的。我把仓库里的 README、config.fish、安装脚本,以及上游工具的官方文档和键位表交叉核对后再落表。

lazygit / btop 官方键位材料

lazygit 用官方英文键位表;btop 用官方 README 里的 help-menu 和 README 内的 GPU 键位说明。btop 如果版本不同,请以程序内帮助为准。