懂AI
zoxide

zoxide

智能目录导航工具 提升命令行效率

zoxide 是一款智能目录导航工具,可替代传统 cd 命令。它能记录常用目录,支持模糊匹配和交互式选择,让用户快速跳转到目标位置。zoxide 兼容主流 shell,安装配置简便,还可导入其他类似工具的数据。通过提升目录导航效率,zoxide 有效提高了命令行操作的效率。

zoxide命令行工具目录跳转shell集成数据导入Github开源项目
访问官网GitHub
<!-- markdownlint-configure-file { "MD013": { "code_blocks": false, "tables": false }, "MD033": false, "MD041": false } --> <div align="center">

<sup>特别感谢：</sup>

<a href="https://www.warp.dev/?utm_source=github&utm_medium=referral&utm_campaign=zoxide_20231001"> <div> <img src="https://yellow-cdn.veclightyear.com/835a84d5/0b588b14-0da6-4927-8d74-cd44c521bd9a.png" width="230" alt="Warp" /> </div> <b> Warp是一款基于Rust的现代终端，内置AI功能，可以帮助您和您的团队 更快地构建出色的软件。 </b> <div> <sup>访问<u>warp.dev</u>了解更多信息。</sup> </div> </a> <hr />

zoxide

[![crates.io][crates.io-badge]][crates.io] [![下载量][downloads-badge]][releases] [![使用Nix构建][builtwithnix-badge]][builtwithnix]

zoxide是一个更智能的cd命令，灵感来自z和autojump。

它会记住您最常使用的目录，因此您只需几个按键就可以"跳转"到这些目录。<br /> zoxide适用于所有主流的shell。

入门指南 • 安装 • 配置 • 集成

</div>

入门指南

![教程][tutorial]

z foo              # 进入与foo最匹配的最高排名目录
z foo bar          # 进入与foo和bar最匹配的最高排名目录
z foo /            # 进入以foo开头的子目录

z ~/foo            # z也可以像普通cd命令一样使用
z foo/             # 进入相对路径
z ..               # 向上一级目录
z -                # 进入上一个目录

zi foo             # 使用交互式选择进入目录（使用fzf）

z foo<SPACE><TAB>  # 显示交互式补全（zoxide v0.8.0+，仅支持bash 4.4+/fish/zsh）

了解更多关于匹配算法的信息，请[点击这里][algorithm-matching]。

安装

zoxide可以通过4个简单的步骤安装：

  1. 安装二进制文件

    zoxide可在大多数主要平台上运行。如果您的平台未列出，请[提交问题][issues]。

    <details> <summary>Linux / WSL</summary>

    推荐通过安装脚本安装zoxide：

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

    或者，您可以使用包管理器：

    发行版仓库安装说明
    任何[crates.io]cargo install zoxide --locked
    任何[asdf]asdf plugin add zoxide https://github.com/nyrst/asdf-zoxide.git <br /> asdf install zoxide latest
    任何[conda-forge]conda install -c conda-forge zoxide
    任何[guix]guix install zoxide
    任何[Linuxbrew]brew install zoxide
    任何[nixpkgs]nix-env -iA nixpkgs.zoxide
    Alpine Linux 3.13+[Alpine Linux Packages]apk add zoxide
    Arch Linux[Arch Linux Extra]pacman -S zoxide
    CentOS 7+[Copr]dnf copr enable atim/zoxide <br /> dnf install zoxide
    Debian 11+1[Debian Packages]apt install zoxide
    Devuan 4.0+[Devuan Packages]apt install zoxide
    Exherbo Linux[Exherbo packages]cave resolve -x repository/rust <br /> cave resolve -x zoxide
    Fedora 32+[Fedora Packages]dnf install zoxide
    Gentoo[Gentoo Packages]emerge app-shells/zoxide
    Manjaropacman -S zoxide
    openSUSE Tumbleweed[openSUSE Factory]zypper install zoxide
    Parrot OS1apt install zoxide
    Raspbian 11+1[Raspbian Packages]apt install zoxide
    Rhino Linux[Pacstall Packages]pacstall -I zoxide-deb
    Slackware 15.0+[SlackBuilds][安装说明][slackbuilds-howto]
    Solus[Solus Packages]eopkg install zoxide
    Ubuntu 21.04+1[Ubuntu Packages]apt install zoxide
    Void Linux[Void Linux Packages]xbps-install -S zoxide
    </details> <details> <summary>macOS</summary>

要安装 zoxide，请使用包管理器：

仓库安装指令
[crates.io]cargo install zoxide --locked
[Homebrew]brew install zoxide
[asdf]asdf plugin add zoxide https://github.com/nyrst/asdf-zoxide.git <br /> asdf install zoxide latest
[conda-forge]conda install -c conda-forge zoxide
[MacPorts]port install zoxide
[nixpkgs]nix-env -iA nixpkgs.zoxide

或者，在终端中运行以下命令：

curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
</details> <details> <summary>Windows</summary>

zoxide 可以与 PowerShell 以及在 Cygwin、Git Bash 和 MSYS2 中运行的 shell 一起使用。

推荐使用 winget 安装 zoxide：

winget install ajeetdsouza.zoxide

或者，你可以使用其他包管理器：

仓库安装指令
[crates.io]cargo install zoxide --locked
[Chocolatey]choco install zoxide
[conda-forge]conda install -c conda-forge zoxide
[Scoop]scoop install zoxide

如果你使用的是 Cygwin、Git Bash 或 MSYS2，你也可以使用安装脚本：

curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
</details> <details> <summary>BSD</summary>

要安装 zoxide，请使用包管理器：

发行版仓库安装指令
任何[crates.io]cargo install zoxide --locked
DragonFly BSD[DPorts]pkg install zoxide
FreeBSD[FreshPorts]pkg install zoxide
NetBSD[pkgsrc]pkgin install zoxide

或者，在终端中运行以下命令：

curl -sS https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | bash
</details> <details> <summary>Android</summary>

要安装 zoxide，请使用包管理器：

仓库安装指令
[Termux]pkg install zoxide

或者，在终端中运行以下命令：

curl -sS https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | bash
</details>

  1. 在你的 shell 中设置 zoxide

    要开始使用 zoxide，请将其添加到你的 shell 中。

    <details> <summary>Bash</summary>

    将以下内容添加到你的配置文件<ins>末尾</ins>（通常是 ~/.bashrc）：

    eval "$(zoxide init bash)"
    </details> <details> <summary>Elvish</summary>

    将以下内容添加到你的配置文件<ins>末尾</ins>（通常是 ~/.elvish/rc.elv）：

    eval (zoxide init elvish | slurp)

    注意 zoxide 只支持 elvish v0.18.0 及以上版本。

    </details> <details> <summary>Fish</summary>

    将以下内容添加到你的配置文件<ins>末尾</ins>（通常是 ~/.config/fish/config.fish）：

    zoxide init fish | source
    </details> <details> <summary>Nushell</summary>

    将以下内容添加到你的环境文件<ins>末尾</ins>（在 Nushell 中运行 $nu.env-path 找到它）：

    zoxide init nushell | save -f ~/.zoxide.nu

    现在，将以下内容添加到你的配置文件<ins>末尾</ins>（在 Nushell 中运行 $nu.config-path 找到它）：

    source ~/.zoxide.nu

    注意 zoxide 只支持 Nushell v0.89.0+。

    </details> <details> <summary>PowerShell</summary>

    将以下内容添加到你的配置文件<ins>末尾</ins>（在 PowerShell 中运行 echo $profile 找到它）：

    Invoke-Expression (& { (zoxide init powershell | Out-String) })
    </details> <details> <summary>Xonsh</summary>

    将以下内容添加到你的配置文件<ins>末尾</ins>（通常是 ~/.xonshrc）：

    execx($(zoxide init xonsh), 'exec', __xonsh__.ctx, filename='zoxide')
    </details> <details> <summary>Zsh</summary>

将以下内容添加到配置文件的<ins>末尾</ins>（通常是 ~/.zshrc）：

eval "$(zoxide init zsh)"

为了使补全功能正常工作，上述行必须添加在 compinit 调用之后。你可能需要通过运行 rm ~/.zcompdump*; compinit 来重建补全缓存。

</details> <details> <summary>任何 POSIX shell</summary>

将以下内容添加到配置文件的<ins>末尾</ins>：

eval "$(zoxide init posix --hook prompt)"
</details>

  1. 安装 fzf <sup>（可选）</sup>

    [fzf] 是一个命令行模糊查找工具，被 zoxide 用于补全和交互式选择。可以从[这里][fzf-installation]安装。

    注意 zoxide 仅支持 fzf v0.33.0 及以上版本。

  2. 导入数据 <sup>（可选）</sup>

    如果你目前使用以下任何插件，可能想要将数据导入到 zoxide：

    <details> <summary>autojump</summary>

    在终端中运行以下命令：

    zoxide import --from=autojump "/path/to/autojump/db"

    路径通常根据你的系统而变：

    操作系统路径示例
    Linux$XDG_DATA_HOME/autojump/autojump.txt 或 $HOME/.local/share/autojump/autojump.txt/home/alice/.local/share/autojump/autojump.txt
    macOS$HOME/Library/autojump/autojump.txt/Users/Alice/Library/autojump/autojump.txt
    Windows%APPDATA%\autojump\autojump.txtC:\Users\Alice\AppData\Roaming\autojump\autojump.txt
    </details> <details> <summary>fasd, z, z.lua, zsh-z</summary>

    在终端中运行以下命令：

    zoxide import --from=z "path/to/z/db"

    路径通常根据你的系统而变：

    插件路径
    fasd$_FASD_DATA 或 $HOME/.fasd
    z (bash/zsh)$_Z_DATA 或 $HOME/.z
    z (fish)$Z_DATA 或 $XDG_DATA_HOME/z/data 或 $HOME/.local/share/z/data
    z.lua (bash/zsh)$_ZL_DATA 或 $HOME/.zlua
    z.lua (fish)$XDG_DATA_HOME/zlua/zlua.txt 或 $HOME/.local/share/zlua/zlua.txt 或 $_ZL_DATA
    zsh-z$ZSHZ_DATA 或 $_Z_DATA 或 $HOME/.z
    </details> <details> <summary>ZLocation</summary>

    在 PowerShell 中运行以下命令：

    $db = New-TemporaryFile
(Get-ZLocation).GetEnumerator() | ForEach-Object { Write-Output ($_.Name+'|'+$_.Value+'|0') } | Out-File $db
zoxide import --from=z $db
    </details>

配置

标志

调用 zoxide init 时，可以使用以下标志：

  • --cmd
    • 更改 z 和 zi 命令的前缀。
    • --cmd j 会将命令更改为（j，ji）。
    • --cmd cd 会替换 cd 命令。
  • --hook <HOOK>
    • 更改 zoxide 增加目录分数的频率：
      Hook描述
      none从不
      prompt在每个 shell 提示符
      pwd每当目录被更改时
  • --no-cmd
    • 防止 zoxide 定义 z 和 zi 命令。
    • 这些函数仍将在你的 shell 中作为 __zoxide_z 和 __zoxide_zi 可用，以便你选择重新定义它们。

环境变量

环境变量可用于配置。它们必须在调用 zoxide init 之前设置。

  • _ZO_DATA_DIR
    • 指定存储数据库的目录。
    • 默认值因操作系统而异：
      操作系统路径示例
      Linux / BSD$XDG_DATA_HOME 或 $HOME/.local/share/home/alice/.local/share
      macOS$HOME/Library/Application Support/Users/Alice/Library/Application Support
      Windows%LOCALAPPDATA%C:\Users\Alice\AppData\Local
  • _ZO_ECHO
    • 设置为 1 时，z 会在导航到匹配的目录之前打印该目录。
  • _ZO_EXCLUDE_DIRS
    • 从数据库中排除指定的目录。
    • 这是作为一个 [globs][glob] 列表提供的，用操作系统特定的字符分隔：
      操作系统分隔符示例
      Linux / macOS / BSD:$HOME:$HOME/private/*
      Windows;$HOME;$HOME/private/*
    • 默认设置为 "$HOME"。
  • _ZO_FZF_OPTS
    • 在交互式选择期间传递给 [fzf] 的自定义选项。请参阅 [man fzf][fzf-man] 获取选项列表。
  • _ZO_MAXAGE
    • 配置[老化算法][algorithm-aging]，限制数据库中的最大条目数。
    • 默认设置为 10000。
  • _ZO_RESOLVE_SYMLINKS
    • 设置为 1 时，z 会在将目录添加到数据库之前解析符号链接。

第三方集成

应用程序描述插件
[aerc]电子邮件客户端原生支持
[alfred]macOS启动器[alfred-zoxide]
[clink]改进版Windows cmd.exe[clink-zoxide]
[emacs]文本编辑器[zoxide.el]
[felix]文件管理器原生支持
[joshuto]文件管理器原生支持
[lf]文件管理器参见[wiki][lf-wiki]
[nnn]文件管理器[nnn-autojump]
[ranger]文件管理器[ranger-zoxide]
[telescope.nvim]Neovim的模糊查找器[telescope-zoxide]
[t]tmux会话管理器原生支持
[tmux-session-wizard]tmux会话管理器原生支持
[vim] / [neovim]文本编辑器[zoxide.vim]
[xplr]文件管理器[zoxide.xplr]
[xxh]通过SSH传输shell配置[xxh-plugin-prerun-zoxide]
[yazi]文件管理器原生支持
[zabb]为路径查找最短可能的查询原生支持
[zsh-autocomplete]zsh的实时自动完成原生支持

Footnotes

  1. Debian / Ubuntu衍生版更新包的速度非常慢。如果你使用的是这些发行版，请考虑使用安装脚本代替。 ↩ ↩2 ↩3 ↩4

编辑推荐精选

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境（IDE），通过自动化和多元协作改变开发流程。利用Trae，团队能够更快速、精确地编写和部署代码，从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能，是提升开发效率的理想工具。

热门AI工具生产力协作转型TraeAI IDE
问小白

问小白

全能AI智能助手，随时解答生活与工作的多样问题

问小白，由元石科技研发的AI智能助手，快速准确地解答各种生活和工作问题，包括但不限于搜索、规划和社交互动，帮助用户在日常生活中提高效率，轻松管理个人事务。

聊天机器人AI助手热门AI工具AI对话
Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手，它拥有超精准的音频识别翻译能力，几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球，无论你是留学生、商务人士、韩剧美剧爱好者，还是出国游玩、多国会议、跨国追星等等，都可以满足你所有需要同传的场景需求，线上线下通用，扫除语言障碍，让全世界的语言交流不再有国界。

讯飞智文

讯飞智文

一键生成PPT和Word，让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目，能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定，还是学生群体的职业生涯规划、实习避坑指南，亦或是活动策划、旅游攻略等内容，它都能提供支持，帮助用户精准表达，轻松呈现各种信息。

热门AI工具AI办公办公工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图
讯飞星火

讯飞星火

深度推理能力全新升级，全面对标OpenAI o1

科大讯飞的星火大模型，支持语言理解、知识问答和文本创作等多功能，适用于多种文件和业务场景，提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台，涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能，能为不同需求的用户提供便捷高效的帮助，助力用户轻松获取信息、解决问题，满足多样化使用场景。

模型训练热门AI工具内容创作智能问答AI开发讯飞星火大模型多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目，由多个知名机构联合参与。该项目提供了高效的 LLM（大语言模型）驱动的语音合成方案，支持语音克隆和语音创建功能，可通过命令行界面（CLI）和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数，生成高质量的语音。该项目适用于多种场景，如有声读物制作、智能语音助手开发等。

咔片PPT

咔片PPT

AI助力，做PPT更简单！

咔片是一款轻量化在线演示设计工具，借助 AI 技术，实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT，提供海量模板、智能美化、素材替换等功能，适用于销售、教师、学生等各类人群，能高效制作出高品质 PPT，满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文，一站式创作，让内容运营更高效

讯飞绘文，一个AI集成平台，支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容，加速品牌传播，提升内容营销效果。

AI助手热门AI工具AI创作AI辅助写作讯飞绘文内容运营个性化文章多平台分发
材料星

材料星

专业的AI公文写作平台，公文写作神器

AI 材料星，专业的 AI 公文写作辅助平台，为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能，支持 30 + 文稿类型生成，助力快速完成领导讲话、工作总结、述职报告等材料，提升办公效率，是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK，助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK，它为开发者提供了与 OpenAI 模型交互的高效工具，支持工具调用、结果处理、追踪等功能，涵盖多种应用场景，如研究助手、财务研究等，能显著提升开发效率，让开发者更轻松地利用 OpenAI 的技术优势。

下拉加载更多