zoxide

名称、版本与用途

  • 名称:zoxide
  • 当前版本:0.9.9
  • 路径:~/.local/bin/zoxide
  • 用途:记录目录访问频率和近期程度,用短关键词替代长路径。

基本语法(Synopsis)

zoxide <COMMAND> [OPTIONS]
z [QUERY ...]
zi [QUERY ...]

[] 表示可选项,... 表示可重复;大写名称表示需要替换的参数。

当前安装与更新

当前是独立二进制,不属于 dpkg,并被本地 common/core 离线 bundle 收录。

可重新运行官方安装器更新,或从官方 release 替换二进制:

curl -sSfL \
  https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh |
  sh

联网执行脚本前应先查看脚本内容。

数据与环境变量

zoxide 通常没有主配置文件,使用环境变量和数据库:

  • 数据目录通常位于 XDG data 目录下。
  • $_ZO_DATA_DIR 可覆盖数据库目录。
  • $_ZO_EXCLUDE_DIRS 可排除目录。
  • $_ZO_FZF_OPTS 可设置交互选择参数。

这些变量必须在 zoxide init 之前设置。

zsh 启动集成

是,.zshrc 中执行:

eval "$(zoxide init zsh)"

这会定义日常使用的 z 和 zi。

基本功能与推荐用法

z project                    # 跳到得分最高的匹配目录
z foo bar                    # 多关键词匹配
z ..                         # 像 cd 一样使用
z -                          # 上一个目录
zi                           # 通过 fzf 交互选择
zoxide query project         # 只输出匹配结果
zoxide query --list --score  # 查看数据库
zoxide remove /old/path      # 删除失效记录

推荐保留 cd 原意,日常用 z 加速跳转。批处理脚本应使用明确路径,不依赖 zoxide 数据库。

示例中的选项、参数与子命令

本表解释本页示例实际出现的选项、参数、子命令及必要的辅助命令语法。

语法元素含义
init SHELL输出指定 shell 的初始化脚本。
query查询数据库并输出最佳匹配目录。
--list列出匹配项。
--score同时显示匹配项分数。
remove PATH从数据库移除路径。
z -跳回上一个目录。
zi使用交互式选择器选择目录。
curl -sSfL下载脚本:静默、显示错误、HTTP 失败即报错并跟随重定向。

官方资料