在终端里频繁 cd 会让你一直在“找目录/复制路径/记层级”上浪费时间。zoxide 会根据你的使用频率与最近访问记录，帮你把“去某个项目目录”变成一个更接近搜索的动作；再配合 fzf 的模糊匹配，你可以在几百个目录里用几次按键就跳转到目标位置。
本文以 macOS 为例（Apple Silicon/Intel 均可），演示如何安装、配置与常用用法，并补充常见问题排查。
zoxide：https://github.com/ajeetdsouza/zoxide
fzf：https://github.com/junegunn/fzf
Homebrew：https://brew.sh/
如果你已经安装 Homebrew，直接执行：
brew install zoxide fzf
fzf 在 macOS 上通常还会附带一个可选的键位与补全脚本安装步骤（不同版本提示可能略有差异）。如果你看到类似提示，可以按提示运行安装脚本；如果没有提示，也不影响后续使用。
zoxide 需要在你的 shell 配置里初始化（zsh 典型位置是 ~/.zshrc）。常见写法如下（二选一即可）：
1) 用 zoxide 默认别名（推荐）：
eval "$(zoxide init zsh)"
这会提供一个 z 命令，用于跳转目录。
2) 自定义命令名（比如用 j）：
eval "$(zoxide init zsh --cmd j)"
然后使用 j 来跳转。
配置完成后，重新加载 shell：
source ~/.zshrc
1) 按关键词跳转：你访问过某个目录后，zoxide 会记住它。之后只要：
z project
它会跳到匹配度最高的目录。你也可以用多个关键词提高准确度：
z work api
2) 直接交互选择（配合 fzf）：如果你的配置启用了交互选择，你可以在候选目录里搜索并回车确认。一个通用思路是把 zoxide 的候选列表丢给 fzf 选择（下面示例仅供参考，可按你的习惯调整）：
zoxide query -l | fzf --height 40% --reverse | xargs -I {} cd "{}"
注意：cd 是 shell 内建命令，直接放到管道里在很多情况下不会改变当前 shell 的工作目录。更稳妥的方式是把这段逻辑做成函数/别名，或用你正在使用的终端插件体系来实现（如 zsh 的函数）。如果你不想折腾交互选择，直接用 z 关键词 也足够好用。
3) 与常见工作流配合：
比如你经常在多个 Git 项目间切换，可以把“进入仓库目录”的动作统一交给 z，再配合 git 子命令完成操作，避免复制粘贴路径。
Q1：输入 z 提示 command not found？
通常是初始化语句没生效：确认 ~/.zshrc 已保存并 source 过；也可以新开一个终端窗口再试。
Q2：跳转结果不准确？
zoxide 需要一定的“访问数据”来学习你的常用路径。你可以先正常进入几次常用目录，让它建立记录；另外也建议使用更具体的关键词组合。
Q3：想卸载/回退？
删除 shell 初始化语句，然后执行：
brew uninstall zoxide fzf
如果你每天要在多个项目目录之间来回切换，zoxide + fzf 能明显减少路径相关的低价值操作。建议先从 z 的关键词跳转用起，熟悉后再逐步引入更高级的交互选择与键位绑定。
