Oh My Fish 安装教程:一条命令部署 Fish Shell 框架,Git 与离线安装全覆盖

原创2026-09-21 10:08:572,178 阅读
文章标签:CLI包管理器

Oh My Fish 安装教程:一条命令部署 Fish Shell 框架,Git 与离线安装全覆盖

Oh My Fish 是一款基于 Fish Shell 的终端框架,它提供核心基础设施,帮助你轻松安装扩展插件、更换 Shell 外观主题。本文将带你通过一条命令完成 Oh My Fish 安装,并完整覆盖 Git 克隆安装与离线安装两种方式,附环境要求、验证方法和安装后的快速上手指南,新手也能 5 分钟部署成功 ✅

Oh My Fish 的 Fish Shell 框架项目标志

一、安装前准备:环境要求与版本检查

Oh My Fish 对运行环境的要求很简单,只需确认两项依赖即可:

依赖 最低版本 检查命令
fish shell 2.2.0+ fish --version
git 1.9.5+ git --version

💡 如果还没有安装 fish,Linux 下可用 sudo apt-get install -y fish,macOS 下可用 brew install fish,CI 环境的安装参考 tools/ci-install-fish.sh。

二、最快方式:一条命令安装 Oh My Fish

打开任意终端,执行下面这条 curl 命令,安装脚本会自动下载并运行,无需任何手动配置:

curl -L https://gitcode.com/gh_mirrors/oh/oh-my-fish/raw/master/bin/install | fish

安装完成后,输入 omf help 看到帮助信息,就说明部署成功了 🎉

自定义安装路径

如果你希望控制 Oh My Fish 的安装位置,可以先下载脚本再指定参数执行:

curl -L https://gitcode.com/gh_mirrors/oh/oh-my-fish/raw/master/bin/install > install
fish install --path=~/.local/share/omf --config=~/.config/omf

执行 install --help 可以查看完整的可自定义选项。

校验安装脚本完整性

出于安全考虑,可以用仓库提供的校验文件验证下载脚本未被篡改:

curl -sL https://gitcode.com/gh_mirrors/oh/oh-my-fish/raw/master/bin/install.sha256 | shasum -a 256 --check

三、Git 克隆安装:适合开发者与内网环境

如果你经常访问源码,或处于内网、希望保留完整仓库,推荐使用 Git 方式克隆后离线执行安装脚本:

git clone https://gitcode.com/gh_mirrors/oh/oh-my-fish
cd oh-my-fish
bin/install --offline

这种方式安装完成后,仓库目录会保留在本机,方便你随时查阅源码和提交贡献。

四、离线安装:使用 tarball 源码包

对于无法联网的机器,可以从 Releases 页面下载 Oh My Fish 源码压缩包(tarball),再执行离线安装:

# 将脚本传入离线安装命令,指向本地 tarball 文件
curl -L https://gitcode.com/gh_mirrors/oh/oh-my-fish/raw/master/bin/install > install
fish install --offline=omf.tar.gz

三种方式怎么选?👇

场景 推荐方式
日常快速部署 一条命令 curl 安装
内网 / 想保留源码 Git 克隆 + --offline
完全离线机器 tarball 离线包安装

五、安装完成后的快速上手

Oh My Fish 自带 omf 命令,帮你管理和扩展 Shell,常用命令如下:

  • omf install <名称> — 安装一个或多个插件包,如 omf install brew
  • omf theme — 列出并切换终端主题,让 Shell 颜值升级
  • omf list — 查看已安装的插件与主题
  • omf update — 一键更新框架核心和全部插件
  • omf search <关键词> — 模糊搜索插件和主题
  • omf doctor — 环境自检排障
  • omf destroy — 彻底卸载 Oh My Fish

📌 插件安装命令的细节(按名称、按 URL 安装)可参考 docs/cli/install.adoc。

了解 Oh My Fish 的启动原理

每次打开新 Shell,框架都会自动初始化配置路径(默认 ~/.config/omf),然后加载 init.fish 启动脚本:它会自动加载已安装的插件、主题以及你的自定义配置。

$OMF_CONFIG 目录下有几个重要文件,非常适合纳入版本管理(dotfiles):

  • theme — 当前使用的主题
  • bundle — 已安装插件/主题清单
  • channel — 更新通道(stable / dev)
  • init.fish / before.init.fish — 自定义启动前后执行的脚本
  • key_bindings.fish — 自定义按键绑定

六、常见问题解答(FAQ)

Q1:安装后 fish 2.6 的右侧提示词让终端不可用?

这是 fish 2.6 与部分终端模拟器的已知回归 Bug,默认主题的右侧提示词会受影响。临时方案是换一个不使用右侧提示词的主题即可(详见 README.md 的 Known Issues)。

Q2:如何把 fish 设为默认 Shell?

echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish

Q3:想彻底卸载怎么办?

执行 omf destroy 即可一键卸载,无需手动清理目录。

更多问题可查阅官方中文文档:docs/zh-CN/FAQ.md、docs/zh-CN/README.md。

写在最后

至此,你已经掌握了 Oh My Fish 的三种安装方式:一条命令极速部署、Git 克隆安装、tarball 离线安装。建议新手先从最快的一条命令开始体验,后续再根据内网或离线需求灵活切换。接下来不妨用 omf theme 换一套喜欢的主题,感受 Fish Shell 框架的魅力 🐟

登录后查看全文
oh-my-fish