Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具
这套 Terminal Stack 由 Ghostty、Fish、Starship、fzf、zoxide、eza、bat 和 Lazygit 组成，覆盖终端窗口、Shell、Prompt、模糊搜索、目录跳转、文件展示和 Git 操作。
整套配置面向 macOS 和 Homebrew。完成后，Ghostty 负责打开终端，Fish 管理交互环境，Starship 显示当前目录和 Git 状态，fzf 与 zoxide 处理搜索和跳转，eza 与 bat 改善文件查看，Lazygit 提供 Git 的终端界面。
安装所需工具
Ghostty 可以通过官方安装包安装，也可以使用 Homebrew Cask。
Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
brew install --cask ghostty其余工具可以一次安装。
Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
brew install fish starship fzf zoxide eza bat lazygit安装完成后检查命令是否已经进入 PATH。
Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
command -v fish starship fzf zoxide eza bat lazygitApple Silicon Mac 通过 Homebrew 安装的命令通常位于
/opt/homebrew/bin/。其他环境先运行 command -v fish，再把实际路径写进 Ghostty 配置。技术栈的职责分工
层级 | 工具 | 职责 |
|---|---|---|
终端模拟器 | Ghostty | 创建终端窗口，处理字体、主题、快捷键和 Shell integration。 |
Shell | Fish | 提供自动建议、补全、环境变量、函数和交互式初始化。 |
Prompt | Starship | 显示目录、Git 状态、语言运行时和其他上下文。 |
搜索与跳转 | fzf、zoxide | 模糊搜索候选项，根据使用记录跳转目录。 |
文件查看 | eza、bat | 展示目录内容，预览带语法高亮的文本。 |
Git TUI | Lazygit | 处理暂存、提交、diff、分支和常见 Git 操作。 |
每个工具负责一个明确范围。替换终端模拟器不会影响 zoxide 的目录记录，调整 Starship 也不需要改 Fish 函数。
配置 Ghostty
macOS 上的 Ghostty 配置文件位于下面的路径。
Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (text)
~/Library/Application Support/com.mitchellh.ghostty/config.ghostty先把 Fish 设置为 Ghostty 启动后的 Shell，并打开 Fish shell integration。
Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (ini)
command = /opt/homebrew/bin/fish
shell-integration = fish字体需要支持 Nerd Font 符号，否则 Starship 中的部分图标会显示成空框。下面是一组可直接使用的视觉配置。
Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (ini)
font-family = "Maple Mono NF CN"
font-size = 15
theme = Kanagawa Wave
window-padding-x = 14
window-padding-y = 10Ghostty 的 Quick Terminal 可以绑定全局快捷键。按下 `
Ctrl + `` 打开顶部终端，再按一次将它隐藏。Quick Terminal 在打开和隐藏之间保留当前会话状态。Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (ini)
quick-terminal-position = top
quick-terminal-screen = mouse
quick-terminal-autohide = true
quick-terminal-animation-duration = 0.15
keybind = global:ctrl+grave_accent=toggle_quick_terminalmacOS 需要为 Ghostty 授予辅助功能权限，
global 快捷键才能在其他应用获得焦点时工作。Quick Terminal 只保留应用运行期间的状态，Ghostty 完全退出后不会恢复这个窗口。配置 Fish
Fish 的主配置文件位于
~/.config/fish/config.fish。PATH、Homebrew、direnv 和通用函数可以放在这里，Starship 与 zoxide 这类交互工具需要限制在交互式会话中初始化。Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (fish)
if status is-interactive
if type -q starship
starship init fish | source
end
if type -q zoxide
zoxide init fish | source
end
endconfig.fish 也可能被非交互式 Fish 进程读取。会产生输出或修改交互界面的命令如果没有 status is-interactive 保护，可能影响 SSH、SCP、rsync 或自动化脚本。Fish 函数可以拆到
~/.config/fish/functions/。例如 nls.fish 和 lsd.fish 可以统一调用下面的命令。Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (fish)
eza -lh --icons=auto $argv配置 Starship
Starship 的配置文件位于
~/.config/starship.toml。如果只需要目录、Git 状态和语言运行时，直接使用 Nerd Font Symbols preset 即可，不需要手写复杂的 Prompt 逻辑。Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
starship preset nerd-font-symbols -o ~/.config/starship.tomlStarship 只负责显示信息。命令补全、历史记录和目录跳转仍由 Fish、fzf 与 zoxide 处理。
使用 fzf 和 zoxide
fzf 从标准输入或文件列表中提供模糊搜索。直接运行
fzf 可以从当前候选项中筛选内容。Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
fzfzoxide 根据目录访问记录提供快速跳转。
z 接收目录名片段，zi 使用交互式候选列表。Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
z <dir-fragment>
zi第一次使用 zoxide 时需要正常进入几个目录，让它建立访问记录。记录增加以后，目录名片段通常就足以定位目标路径。
使用 eza、bat 和 Lazygit
eza 用于目录列表，
--icons=auto 会在当前字体支持时显示文件图标。Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
eza -lh --icons=autobat 用于文本预览。
-p 会隐藏额外边框，只保留文本和语法高亮。Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
bat -p <file>Lazygit 在 Git 仓库中直接运行。
Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (shell)
lazygit暂存文件、查看 diff、提交和切换分支都可以在 Lazygit 中完成。复杂操作仍可使用原生 Git 命令，两者可以同时保留。
配置代理与环境变量
代理函数可以收敛成三个命令，避免在不同终端窗口中手动修改多组环境变量。
Terminal Stack 配置指南，Ghostty、Fish 与常用命令行工具 (fish)
proxy on
proxy off
proxy status自动打开代理会影响本地服务、Docker 和部分测试命令。需要直连本机服务时，先执行
proxy off，或者在单条命令中清理 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY。限制启动配置的内容
config.fish 适合保存稳定的 PATH、Prompt 初始化、direnv hook 和通用函数。项目 token、API key 与一次性调试变量应放在项目本地的 .envrc、私密环境文件、密码管理器或 Secret Manager 中。启动配置会被频繁读取，影响所有终端会话。把项目状态和密钥限制在项目目录内，可以减少变量污染，也能避免配置文件进入同步或版本控制后泄露敏感信息。