zoxide 故障排除
本教程将帮助你解决 zoxide 使用中的常见问题。
安装问题
问题 1：命令未找到
症状：提示 zoxide: command not found 或 z: command not found
解决方案：
-
检查安装：
-
检查 PATH：
-
重新安装：
问题 2：安装失败
症状：安装过程中出现错误
解决方案：
-
更新 Rust：
-
清理缓存：
-
使用包管理器：
配置问题
问题 3：配置不生效
症状：添加配置后，zoxide 仍然不工作
解决方案：
-
检查配置文件：
-
重新加载 Shell：
-
检查语法错误：
问题 4：与其他工具冲突
症状：zoxide 与其他工具（如 autojump）冲突
解决方案：
-
卸载冲突工具：
-
使用不同别名：
功能问题
问题 5：跳转不准确
症状：z 命令跳转到错误的目录
解决方案：
-
使用交互式选择：
-
查看匹配列表：
-
手动添加目录：
问题 6：数据库问题
症状：数据库损坏或过大
解决方案：
-
备份并重建：
-
检查数据库大小：
性能问题
问题 7：启动速度慢
症状：Shell 启动变慢
解决方案：
-
延迟初始化：
-
优化配置顺序：
问题 8：查询速度慢
症状：z 命令执行缓慢
解决方案：
-
排除不需要的目录：
-
限制历史记录：
-
清理数据库：
平台特定问题
问题 9：Windows 路径问题
症状：Windows 上路径处理不正确
解决方案：
-
使用 PowerShell：
-
检查路径格式： 确保使用正确的路径分隔符。
问题 10：macOS 权限问题
症状：无法访问某些目录
解决方案：
-
检查权限：
-
修复权限：
调试技巧
启用调试模式
检查数据库内容
测试配置
获取帮助
官方资源
- GitHub Issues：https://github.com/ajeetdsouza/zoxide/issues
- 文档：https://github.com/ajeetdsouza/zoxide
- 社区讨论：GitHub Discussions
常见问题
查看 FAQ 页面 了解更多常见问题。
总结
大多数问题都可以通过以下步骤解决：
- 检查安装和配置
- 重新加载 Shell
- 清理并重建数据库
- 查看官方文档和 Issues
如果问题仍然存在，可以在 GitHub 上提交 Issue。