zoxide 命令未找到 - 解决方法
安装完成后提示 "zoxide command not found"，可以按以下步骤排查并修复。
常见原因
- zoxide 没有在 PATH 中
- Shell 配置没有加载
- 安装未成功完成
- 安装路径或方式与系统不匹配
方案 1：确认是否安装成功
先检查是否真的安装了 zoxide：
如果未找到，请根据平台重新安装（参考 安装指南）。
方案 2：把 zoxide 加入 PATH
Linux / macOS
Cargo 安装：
手动安装：
Windows
Cargo 安装：
手动安装：
修改 PATH 后请重启终端窗口。
方案 3：确认 Shell 初始化
确保在 Shell 配置文件中初始化了 zoxide：
Bash (~/.bashrc)：
Zsh (~/.zshrc)：
Fish (~/.config/fish/config.fish)：
PowerShell ($PROFILE)：
添加后重新加载配置：Bash/Zsh 使用 source，Fish 使用 source ~/.config/fish/config.fish，PowerShell 使用 . $PROFILE。
方案 4：检查安装方式
Homebrew（macOS）
Scoop（Windows）
Cargo
若找不到 cargo，先安装 Rust：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 并 source $HOME/.cargo/env。
方案 5：在新终端测试
有时 PATH 变更在当前窗口未生效：
- 关闭当前终端
- 打开新终端
- 再次运行
zoxide --version
快速诊断命令
仍然无法解决？
- 按官方推荐方式重装 zoxide
- 查看系统日志/安装输出是否有错误
- 确认所用 Shell 受支持（bash、zsh、fish、PowerShell）
- 检查权限，确保二进制可执行：
预防
- 优先使用包管理器（Homebrew、Scoop）安装
- 安装后立即把目录加入 PATH
- 完成安装后立刻测试
- 保持 Shell 配置整洁可维护