Zoxide Commands 终极指南：光速导航你的终端
如果你是一名长期生活在命令行的开发者，你会知道 cd 命令既是你的朋友，也是你效率的瓶颈。输入冗长的绝对路径、处理拼写错误、记忆复杂的目录树，这些认知负担每天都在消耗你的精力。Zoxide 是一个受 z 和 autojump 启发的智能工具，它能学习你的习惯，追踪你最常访问的目录，让你只需敲击几次键盘即可跳转到任何地方。
然而，许多用户仅仅止步于安装它并使用基础的 z 别名。要真正解锁这个基于 Rust 的工具的生产力潜力，你需要掌握全套的 zoxide commands（Zoxide 指令）。本指南将带你深入 Zoxide 的命令行界面，探索从数据库管理到高级查询技术的方方面面。
为什么要掌握 Zoxide Commands？
Zoxide 基于"Frecency"（频率 + 新近度）算法运行。虽然它开箱即用，但理解具体的 zoxide commands 能让你做到：
- 调试导航问题： 为什么
z foo跳转到了foobar而不是foo-project？ - 清理历史记录： 从数据库中移除不存在或敏感的目录。
- 脚本化工作流： 在 Bash 或 Python 脚本中使用 Zoxide 的查询引擎。
- 数据迁移： 导入其他工具的历史记录，无需从头开始。
让我们拆解这些核心指令。
1. 初始化指令：基础
在你开始跳转之前，必须将 Zoxide 集成到你的 Shell 中。这是由 init 命令处理的，它会生成必要的 Shell 脚本来挂钩你的提示符。
基础 Init
结构为 zoxide init <shell>。
这会设置 z 别名和 zi 交互式命令。
--cmd 标志（大招）
默认情况下，Zoxide 使用 z。但肌肉记忆很难改变。初始化 zoxide commands 中最强大的一招是完全替换 cd。
当你使用 --cmd cd 时：
- 空格键兼容性： 如果你输入有效路径，它的行为仍像普通
cd。 - 智能跳转： 如果本地路径不存在，它会查询数据库。
- 记录一切： 这确保了每一次导航事件都被记录，使得数据库随着时间的推移变得极其精准。
2. 核心导航指令
这些是你每天会执行数百次的 zoxide commands。
跳转：z
这是最基础的操作。你不需要输入目录的全名。
Zoxide 足够智能，可以处理模糊匹配。如果你有 work-personal 和 work-business，输入 z bus 通常足以消除歧义。
交互式跳转：zi
有时算法还不够，或者你有五个名为 "src" 的目录。zi 命令利用 fzf（模糊查找器）提供一个可选列表。
这会打开一个交互式界面，显示排名靠前的目录。你可以输入字符过滤列表并按回车跳转。这经常被认为是探索旧项目最有用的 zoxide commands 之一。
3. 数据库管理指令 (add 与 remove)
Zoxide 维护一个数据库文件（通常在 ~/.local/share/zoxide/db.zo）。虽然它具有自愈功能（在进入失败时移除不存在的目录），但有时需要手动管理。
zoxide add
你可以手动训练算法。这对于你尚未访问过但计划频繁使用的新项目非常有用。
使用 add 确保该目录立即可用于跳转，即使你还没有技术性地 cd 进去过。
zoxide remove
如果你有一个想要 Zoxide "忘记"的目录——也许是一个秘密项目或会在自动补全中产生干扰的临时构建文件夹——你可以使用移除命令。
专家提示： 保持数据库清洁能让模糊匹配更准确。
4. 核心大脑：zoxide query
对于脚本编写者和高级用户来说，zoxide query 是最重要的命令。它暴露了工具的原始逻辑，而不会实际改变你的目录。
基础查询
这会输出 z foo 将会跳转到的绝对路径。它不会移动你；它只是打印字符串。
列出匹配项 (--list / -l)
如果你想查看某个关键字的所有潜在候选者：
这会返回所有匹配 "foo" 的目录列表，按排名排序。
评分 (--score / -s)
这对于调试至关重要。如果你想知道为什么 Zoxide 偏爱一个目录而不是另一个，请使用分数标志。
输出示例：
数字代表 "frecency" 分数。你可以看到算法如何权衡你的习惯。如果你想提升 old-project，你可以简单地多次 zoxide add 它来人为地提高其分数。
验证 (--all / -a)
默认情况下，zoxide query 只返回当前存在于文件系统上的目录。如果你正在审计数据库以查看所有内容（包括尚未清除的已删除文件夹），请使用 --all 标志。
5. 迁移指令：import
如果你是从 autojump 或原始的 z 迁移过来的，你不需要丢失数年的导航历史。Zoxide 包含特定的命令来平滑处理这种转换。
运行一次即可将你现有的习惯填充到 db.zo 文件中。
6. 在脚本中使用 Zoxide Commands
Zoxide 优于 Shell 别名的一个主要优点是其二进制特性，这使得在 Shell 脚本中使用它既安全又容易。
场景： 你想要一个脚本在编辑器中打开你最新的项目。 你可以利用 zoxide commands 而不是硬编码路径：
这使得你的脚本具有动态性。如果你将 React 项目移动到新驱动器，只要 Zoxide 知道新位置，脚本仍然有效。
结语
虽然人们很容易将 Zoxide 仅仅视为"神奇的 cd"，但花时间学习具体的 zoxide commands——特别是 query、add 和 remove——能将它从一个实用程序转变为一个生产力平台。
通过掌握初始化标志来替换 cd，使用 zi 进行视觉导航，并理解如何阅读 score 输出，你将确保你的终端行为完全符合你的预期。命令行的强大在于其精确性；而 Zoxide 为这种精确性增添了智慧。