什么是 zoxide？
zoxide is a smarter cd command written in Rust by Ajeet D'Souza, inspired by z and autojump. It remembers which directories you use most frequently, so you can "jump" to them in just a few keystrokes. With over 28k GitHub stars, it has revolutionized directory navigation for command-line users worldwide.
⚡ Key Features of zoxide
🧠 Smart Learning
Learns your directory usage patterns and ranks them by frequency and recency. The more you visit a directory, the easier it becomes to access.
🔍 Fuzzy Matching
Jump to directories with partial matches. Type just a few characters and zoxide will find the right directory based on your history.
🐚 Universal Shell Support
Works with bash, zsh, fish, PowerShell, Nushell, Elvish, Tcsh, and Xonsh. Consistent experience across all major shells.
🔌 Rich Integrations
Native integration with fzf for interactive selection, plus plugins for Vim, Emacs, file managers, and tmux session managers.
📊 Data Import
Import existing data from autojump, z, z.lua, fasd, and other directory jumpers. No need to start from scratch.
⚙️ Highly Configurable
Customizable scoring algorithm, exclude patterns, aging settings, and command prefixes. Adapts to your workflow preferences.
🏆 Productivity Benefits
- Save Time: Jump to any directory in 2-3 keystrokes instead of typing full paths
- Reduce Errors: No more typos in long directory paths
- Learn Patterns: Automatically adapts to your most-used directories
- Cross-Session: Remembers directories across terminal sessions
- Interactive Mode: Use with fzf for visual directory selection
apt upgrade 即可始终保持最新版本。
📦 从 deb.griffo.io 安装
步骤 1：添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 有一个永久免费的镜像。 deb-free.griffo.io 永久免费提供软件包 — 无需账号、无需订阅，最多落后上游 2 个月，安全修复立即发布。目前收录 cliamp、Ghostty、lazydocker、Oh My Posh 和 Zed；zoxide 不在其中，因此今天只能通过上面的仓库安装 — 提出请求即可将其加入。
🧩 关于 extrepo 选项。 extrepo 是 Debian 官方用于管理第三方仓库的工具：它会替你写好 sources 文件并安装签名密钥，并在使用前先对照签名元数据校验该密钥。本仓库以 griffo 之名登记其中，永久免费镜像则为 griffo-free，因此在 Debian（bookworm、trixie、forky、sid）上，上面的命令就是全部配置。
extrepo 只负责 sources 文件和密钥，订阅凭据仍然要写入 /etc/apt/auth.conf.d/deb.griffo.io.conf。Ubuntu 不在覆盖范围内，因为 extrepo 只发布 Debian 各套件的元数据：在 Ubuntu 上请使用 sudo 或 root 的命令。
步骤 2：安装 zoxide
# Install latest zoxide
sudo apt install zoxide
# Verify installation
zoxide --version# Install latest zoxide
apt install zoxide
# Verify installation
zoxide --versionStep 3: Set Up Shell Integration
# For bash users
echo 'eval "$(zoxide init bash)"' >> ~/.bashrc
# For zsh users
echo 'eval "$(zoxide init zsh)"' >> ~/.zshrc
# For fish users
echo 'zoxide init fish | source' >> ~/.config/fish/config.fish
# Reload shell
source ~/.bashrc # or ~/.zshrc🎯 基本使用示例
Smart directory jumping:
# Jump to directory containing "projects"
z projects
# Jump to directory matching "my" and "app"
z my app
# Jump to subdirectory starting with "src"
z src/
# Go back to previous directory
z -
# Interactive selection with fzf
ziTraditional cd still works:
# Regular cd functionality
z ~/Documents
z ../
z /usr/local/bin
# Relative paths
z ./src/componentsAdvanced features:
# Query directories without jumping
zoxide query projects
# Add directory manually
zoxide add /path/to/directory
# Remove directory from database
zoxide remove /path/to/directory
# Import from other tools
zoxide import --from=autojump ~/.local/share/autojump/autojump.txt
zoxide import --from=z ~/.zCustomization:
# Use different command prefix (j instead of z)
eval "$(zoxide init bash --cmd j)"
# Replace cd command entirely
eval "$(zoxide init bash --cmd cd)"
# Echo directory before jumping
export _ZO_ECHO=1
# Exclude certain directories
export _ZO_EXCLUDE_DIRS="$HOME:$HOME/private/*"🚀 为什么选择 deb.griffo.io？
- Official Debian: Available but often outdated versions
- Cargo Install: Requires Rust toolchain and compilation
- Install Script: Manual updates and no package management
- deb.griffo.io: Latest version with automatic updates
- ✅ Latest Algorithm: Get newest scoring and matching improvements
- ✅ No Rust Compilation: Pre-built binaries, no toolchain needed
- ✅ Automatic Updates: Packages updated within hours of upstream releases
- ✅ Complete Package: Includes shell integration and documentation
- ✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
- ✅ Easy Maintenance: Standard apt commands for updates
📦 软件包构建仓库
Debian 软件包在此 GitHub 仓库中自动构建和维护：
- 📂 zoxide-debian - Latest release builds
🔗 相关软件包
也可从 deb.griffo.io 获取：
- fzf Fuzzy Finder - Perfect companion for interactive zoxide selection
- eza - Modern ls replacement for better directory listing
- Yazi File Manager - Integrates with zoxide for smart navigation