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