Windows 系统使用 Rust 安装 zoxide 教程
什么是 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
基本命令
-
z
– 快速跳转# 跳转到包含 "docs" 的目录 z docs # 跳转到包含 "proj" 和 "rust" 的目录 z proj rust
-
zi
– 交互式选择# 打开交互式目录选择器 zi
-
查看数据库
# 查看 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 配置文件中删除相关代码。