zoxide

zoxide — 一个更智能的 cd 命令，让你告别频繁的目录切换痛苦

如果你跟我一样，每天要在终端里开几十个窗口，切几十次目录，那你大概率对 cd 这个命令又爱又恨。爱的是它简单，恨的是它太傻——明明我上个小时刚进过那个深藏在 /var/www/project/src/components 的目录，现在又得敲一遍完整路径，或者用 cd .. 一层层往回退，再重新 cd 进去。手指头都快磨出茧子了。

这就是 zoxide 要解决的核心问题：用模糊匹配 + 频率学习，让你用最短的输入跳到最想去的目录。

它是怎么做到的？

zoxide 本质上是一个增强版的 cd，但它背后有一套轻量级的排名算法。它会记录你每次进入过的目录，根据访问频率、最近访问时间、目录深度等维度给每个目录打分。下次你输入 z foo，它不会像 cd 那样严格匹配 foo 这个名字，而是会从你的历史记录里找出所有跟 foo 相关的目录，然后挑出得分最高的那个跳过去。

举个例子：你经常去 /home/me/work/project-foo，偶尔去 /tmp/foo-test。当你输入 z foo 时，它会直接跳到第一个目录，因为你去得最多。如果你想去第二个，输入 z foo test 或者 z foo tmp 就能精准匹配。这比 cd 的 Tab 补全快了不止一个量级。

更贴心的是，它完全兼容原有的 cd 命令，不会破坏你现有的肌肉记忆。你可以继续用 cd，也可以用 z 来加速，两者互不干扰。

下载和安装

zoxide 的官方网站在这里：https://github.com/ajeetdsouza/zoxide（GitHub 仓库，文档和源码都在）。如果你是 macOS 用户，可以直接用 Homebrew 装，一条命令搞定：

brew install zoxide

Linux 用户用包管理器也很方便：

# Ubuntu/Debian
sudo apt install zoxide

# Arch Linux
sudo pacman -S zoxide

# Fedora
sudo dnf install zoxide

Windows 用户别慌，它支持 scoop 和 winget：

scoop install zoxide
# 或者
winget install zoxide

如果这些都不行，你还可以去 GitHub Releases 页面下载编译好的二进制文件，扔到 PATH 里就能用。体积极小，不到 1MB，属于那种“装了就忘不掉”的工具。

安装后的配置

装完只是第一步，还得让 shell 认识它。根据你用的 shell 不同，要在对应的配置文件里加一行。zoxide 支持 bash、zsh、fish、powershell 等主流 shell。

如果你用 bash，在 ~/.bashrc 末尾加上：

eval "$(zoxide init bash)"

如果你用 zsh，在 ~/.zshrc 末尾加上：

eval "$(zoxide init zsh)"

如果你用 fish，在 ~/.config/fish/config.fish 末尾加上：

zoxide init fish | source

如果你用 PowerShell，在 $PROFILE 里加上：

Invoke-Expression (& { (zoxide init powershell) })

加完之后重新加载配置文件（比如 source ~/.zshrc），或者新开一个终端窗口，zoxide 就开始工作了。

基础使用教程

安装配置好之后，你不需要任何学习成本，直接把它当成 cd 的超级版本来用就行。最常用的命令就这几个：

1. z <关键词> —— 跳到最匹配的目录

# 假设你去过 /home/me/projects/python/awesome-app
z awesome-app    # 直接跳过去
z py awe         # 模糊匹配也能行
z app            # 如果这个目录访问频率最高，也会跳到它

2. zi <关键词> —— 交互式选择（模糊搜索）

有时候关键词太宽泛，匹配到多个目录，你不确定哪个是想要的。这时候用 zi 会弹出一个交互式列表，你可以用方向键选择，或者继续打字筛选：

zi proj
# 显示：
# 1. /home/me/projects/python
# 2. /home/me/work/projects
# 3. /tmp/old-projects
# 输入编号或继续打字

3. zq <关键词> —— 只输出路径，不跳转

这个适合在脚本里用，比如你想把路径存到变量里，或者传给其他命令：

echo $(zq awesome-app)
# 输出：/home/me/projects/python/awesome-app

4. zoxide add <路径> —— 手动添加目录到数据库

zoxide 默认会自动记录你 cd 过的目录，但如果你用其他方式进入目录（比如通过文件管理器、tmux 会话），可以手动添加：

zoxide add /some/deep/path

5. zoxide remove <路径> —— 删除记录

如果你去过一个临时目录，后来不想让它出现在搜索结果里：

zoxide remove /tmp/temp-build

进阶技巧

用熟了之后，你会发现 zoxide 还有很多隐藏玩法，能进一步解放双手。

技巧一：用别名替代 cd

如果你像我一样，已经习惯了 cd 这个动作，可以给 z 起个别名，这样每次敲 cd 时实际上是在用 zoxide：

# 在 shell 配置文件里加上
alias cd='z'

但注意，这样会完全覆盖原生的 cd，如果你偶尔需要严格按路径跳转，可以用 \cd 来调用原生命令（反斜杠会跳过别名）。

技巧二：配合 fzf 实现终极模糊搜索

zi 虽然好用，但 fzf 的交互式体验更丝滑。你可以把 zoxide 和 fzf 结合起来，实现类似“输入关键词 → 实时模糊搜索 → 回车跳转”的效果：

# 定义一个函数，集成 zoxide + fzf
j() {
  local dir
  dir=$(zoxide query --list | fzf --height 40% --reverse)
  if [ -n "$dir" ]; then
    cd "$dir"
  fi
}

把这个函数加到 shell 配置里，以后输入 j 就会弹出 fzf 的搜索窗口，你可以打字、用方向键、甚至用 Ctrl+R 翻历史，选中后直接跳转。

技巧三：用环境变量控制行为

zoxide 有几个环境变量可以调节它的行为：

• $_ZO_DATA_DIR：指定数据库文件存放位置，默认在 ~/.local/share/zoxide。
• $_ZO_MAXAGE：数据库记录的最大存活天数，默认是 365 天，超过的记录会被清理。
• $_ZO_RESOLVE_SYMLINKS：是否解析符号链接，默认不解析。

比如你想让数据库不占用太多空间，可以设置：

export $_ZO_MAXAGE=90   # 只保留 90 天内的记录

技巧四：在 tmux 里共享数据库

如果你经常开多个 tmux 窗口，每个窗口的 shell 进程是独立的，默认情况下 zoxide 的数据库是共享的（因为它用的是同一个文件）。但如果你发现不同窗口的记录没有同步，检查一下是不是每个 shell 都正确初始化了 zoxide。最稳妥的做法是在 tmux 的配置里统一设置环境变量，或者把 eval "$(zoxide init zsh)" 写到全局的 shell 配置里（而不是 ~/.zshrc 这种每个会话独立的文件）。

技巧五：用 zoxide query --list 导出所有记录

如果你想备份或分析自己的目录访问习惯：

zoxide query --list > ~/zoxide_backup.txt

这个命令会输出所有记录的完整路径，每行一个。你可以用 sort | uniq -c 来统计每个目录的访问频率，看看自己平时都在哪个项目里摸鱼。

一点小提醒

zoxide 虽好，但有个小坑：如果你经常用 cd 进入临时目录（比如 /tmp/build-xxx），这些目录也会被记录到数据库里，导致搜索结果变脏。我的习惯是定期用 zoxide remove 清理，或者在进入临时目录后主动删除记录。另外，如果你用的是 WSL，zoxide 在 Windows 和 Linux 文件系统之间跳转可能会有点慢，因为跨文件系统的路径解析需要时间，但日常使用完全没问题。

总的来说，zoxide 是我装机必备的工具之一，没有它我可能每天得多敲几百次 Tab 键。如果你还在忍受 cd 的笨拙，花 5 分钟装一个 zoxide，你会回来感谢我的。