fish-shell / fish-shell

32,3742,214+28 todayRust

The user-friendly command line shell.

📖 README

.. |Cirrus CI| image:: https://api.cirrus-ci.com/github/fish-shell/fish-shell.svg?branch=master :target: https://cirrus-ci.com/github/fish-shell/fish-shell :alt: Cirrus CI Build Status`fish ` - the friendly interactive shell |Build Status| |Cirrus CI| =============================================================================================fish is a smart and user-friendly command line shell for macOS, Linux, and the rest of the family. fish includes features like syntax highlighting, autosuggest-as-you-type, and fancy tab completions that just work, with no configuration required.For downloads, screenshots and more, go to https://fishshell.com/.Quick Start -----------fish generally works like other shells, like bash or zsh. A few important differences can be found at https://fishshell.com/docs/current/tutorial.html by searching for the magic phrase “unlike other shells”.Detailed user documentation is available by running ``help`[代码]Homebrew `: ``brew install fish`` • using `MacPort...

📊 Project Info

Language: Rust
Stars: ⭐ 32,374
Forks: 2,214
Today: +28
Ranking: #8
Collection: Overall
Trending Date: February 5, 2026

🏷️ Topics

fishrustshellterminal

5分钟上手 Fish Shell

本指南将帮助你在5分钟内安装并启动Fish Shell，体验其智能提示和语法高亮功能。

🖥️ OS

macOSLinuxWindows (通过Cygwin或MSYS2)

🔧 Tools

包管理器（可选）— 用于快速安装Fish Shell，如Homebrew、apt、yum等

📝 Steps

安装Fish Shell

根据你的操作系统选择合适的安装方法。以下是最常用的几种方式：

通过Homebrew安装

$ # macOS (使用Homebrew)
brew install fish

通过PPA仓库安装

$ # Ubuntu/Debian
sudo apt-add-repository ppa:fish-shell/release-3
sudo apt update
sudo apt install fish

通过dnf安装

$ # Fedora
sudo dnf install fish

通用方法

$ # 其他Linux发行版
# 请参考 https://fishshell.com/ 下载对应包

✓Expected: 安装过程无错误，显示安装成功信息

💡如果使用其他操作系统或包管理器，请访问 https://fishshell.com/ 查看完整安装指南

启动Fish Shell

安装完成后，启动Fish Shell开始使用

在当前终端中启动Fish Shell

$ fish

✓Expected: 终端提示符变为彩色，显示类似 `username@hostname ~>` 的格式

💡第一次启动时，Fish会显示欢迎信息

体验Fish特性

尝试Fish Shell的核心功能

输入命令时观察语法高亮

$ cd /

输入命令时观察自动建议（灰色提示）

$ ls -la

输入git sta后按Tab键，观察自动补全

$ git sta<Tab>

✓Expected: 1. 命令语法正确时显示绿色，错误时显示红色 2. 输入命令时显示灰色建议 3. 按Tab键显示相关补全选项

💡Fish的自动建议基于你的命令历史，用得越多越智能

设置为默认Shell（可选）

如果你喜欢Fish，可以将其设置为默认Shell

获取fish的完整路径

$ # 查看fish的安装路径
which fish

将fish添加到可用shell列表

$ # 将路径添加到/etc/shells（需要管理员权限）
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells

将fish设置为你的默认shell

$ # 更改默认shell
chsh -s /usr/local/bin/fish

✓Expected: 执行chsh后可能需要重新登录才能生效

💡在更改默认shell前，确保你熟悉Fish的基本操作。你可以随时用`bash`或`zsh`命令切换回原来的shell

✅ 验证成功

确认Fish Shell已正确安装并运行

✓成功启动Fish Shell，提示符变为彩色
✓输入命令时有语法高亮显示
✓输入命令时出现灰色自动建议
✓按Tab键能显示智能补全选项

⚡ Quick Tips

配置输入`help`命令可以打开Fish的交互式帮助文档

性能使用`alt+→`可以接受自动建议的完整命令

配置输入`funced`可以快速编辑函数，`funcsave`保存函数

其他要退出Fish Shell，输入`exit`或按`Ctrl+D`

🔍 Troubleshooting

❓ 安装命令找不到或失败

→ 1. 确保包管理器已更新（如`brew update`） 2. 检查网络连接 3. 访问 https://fishshell.com/ 手动下载安装包

❓ Fish Shell启动后提示符不正常

→ 可能是配置文件问题，尝试运行`fish --command="echo test"`测试基本功能

❓ 自动建议或补全不工作

→ 1. 确保终端支持颜色和特殊字符 2. 尝试重新启动Fish Shell 3. 检查是否有配置文件冲突

❓ 想暂时切换回原来的Shell

→ 在Fish中直接输入`bash`、`zsh`或你原来的shell名称即可

🎯 Next Steps

学习Fish语法

访问 https://fishshell.com/docs/current/tutorial.html 学习Fish特有语法

配置Fish

编辑`~/.config/fish/config.fish`文件自定义Fish配置

安装插件

通过Fisher等插件管理器扩展Fish功能

查看高级功能

探索Fish的变量、函数、事件等高级特性