懂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

编辑推荐精选

博思AIPPT

博思AIPPT

AI一键生成PPT，就用博思AIPPT！

博思AIPPT，新一代的AI生成PPT平台，支持智能生成PPT、AI美化PPT、文本&链接生成PPT、导入Word/PDF/Markdown文档生成PPT等，内置海量精美PPT模板，涵盖商务、教育、科技等不同风格，同时针对每个页面提供多种版式，一键自适应切换，完美适配各种办公场景。

AI办公办公工具AI工具博思AIPPTAI生成PPT智能排版海量精品模板AI创作热门
潮际好麦

潮际好麦

AI赋能电商视觉革命，一站式智能商拍平台

潮际好麦深耕服装行业，是国内AI试衣效果最好的软件。使用先进AIGC能力为电商卖家批量提供优质的、低成本的商拍图。合作品牌有Shein、Lazada、安踏、百丽等65个国内外头部品牌，以及国内10万+淘宝、天猫、京东等主流平台的品牌商家，为卖家节省将近85%的出图成本，提升约3倍出图效率，让品牌能够快速上架。

iTerms

iTerms

企业专属的AI法律顾问

iTerms是法大大集团旗下法律子品牌，基于最先进的大语言模型(LLM)、专业的法律知识库和强大的智能体架构，帮助企业扫清合规障碍，筑牢风控防线，成为您企业专属的AI法律顾问。

SimilarWeb流量提升

SimilarWeb流量提升

稳定高效的流量提升解决方案，助力品牌曝光

稳定高效的流量提升解决方案，助力品牌曝光

Sora2视频免费生成

Sora2视频免费生成

最新版Sora2模型免费使用，一键生成无水印视频

最新版Sora2模型免费使用，一键生成无水印视频

Transly

Transly

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

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

讯飞绘文

讯飞绘文

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

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

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

TRAE编程

AI辅助编程，代码自动修复

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

AI工具TraeAI IDE协作生产力转型热门
商汤小浣熊

商汤小浣熊

最强AI数据分析助手

小浣熊家族Raccoon，您的AI智能助手，致力于通过先进的人工智能技术，为用户提供高效、便捷的智能服务。无论是日常咨询还是专业问题解答，小浣熊都能以快速、准确的响应满足您的需求，让您的生活更加智能便捷。

imini AI

imini AI

像人一样思考的AI智能体

imini 是一款超级AI智能体，能根据人类指令，自主思考、自主完成、并且交付结果的AI智能体。

下拉加载更多