Windows 系统使用 Rust 安装 zoxide 教程

  • 2025年7月5日
  • 0 comments

什么是 zoxide?

zoxide 是一个更智能的 cd 命令,它会记录你访问过的目录,让你能够通过部分路径名快速跳转到常用目录。

前置要求

1. 安装 Rust

访问 https://rustup.rs/ 下载 rustup-init.exe,运行后按提示安装。

验证安装:

rustc --version
cargo --version

安装 zoxide

1. 使用 Cargo 安装

打开 PowerShell,运行:

cargo install zoxide --locked

2. 验证安装

zoxide --version

如果提示找不到命令,可能需要重启 PowerShell 或检查 PATH 环境变量。

配置 PowerShell

1. 创建配置文件

检查配置文件是否存在:

Test-Path $PROFILE

如果返回 False,创建配置文件:

New-Item -Path $PROFILE -Type File -Force

2. 编辑配置文件

notepad $PROFILE

3. 添加 zoxide 初始化代码

在打开的记事本中添加以下内容:

Invoke-Expression (& {
    $hook = if ($PSVersionTable.PSVersion.Major -lt 6) { 'prompt' } else { 'pwd' }
    (zoxide init --hook $hook powershell | Out-String)
})

保存并关闭文件。

4. 重新加载配置

关闭并重新打开 PowerShell,或者运行:

. $PROFILE

使用 zoxide

基本命令

  1. z – 快速跳转

    # 跳转到包含 "docs" 的目录
    z docs
    
    # 跳转到包含 "proj" 和 "rust" 的目录
    z proj rust
  2. zi – 交互式选择

    # 打开交互式目录选择器
    zi
  3. 查看数据库

    # 查看 zoxide 记录的所有目录
    zoxide query -l

使用技巧

  • 多访问常用目录,zoxide 会自动学习你的使用习惯
  • 路径匹配支持模糊搜索,不需要输入完整路径
  • 访问频率越高的目录,优先级越高

故障排除

1. 找不到 zoxide 命令

确保 ~\.cargo\bin 在系统 PATH 中:

$env:Path -split ';' | Select-String cargo

如果没有,手动添加到用户环境变量。

2. PowerShell 配置文件错误

如果出现编码问题,确保配置文件使用 UTF-8 编码保存。

3. 初始化失败

尝试使用完整路径:

Invoke-Expression (& {
    $hook = if ($PSVersionTable.PSVersion.Major -lt 6) { 'prompt' } else { 'pwd' }
    (& "$env:USERPROFILE\.cargo\bin\zoxide.exe" init --hook $hook powershell | Out-String)
})

卸载

如需卸载:

cargo uninstall zoxide

然后从 PowerShell 配置文件中删除相关代码。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注