Yazi 终端文件管理器使用指南
简介
Yazi 是基于 Rust 开发的现代终端文件管理器，采用异步 I/O 架构，速度极快且功能强大。
核心特性：
- 异步操作，多线程 CPU 任务分发
- 内置图片预览、代码高亮
- Lua 插件系统，高度可定制
- 支持文件搜索、批量操作、回收站
安装
推荐方式（预编译二进制）
1. 下载最新版本
wget https://github.com/sxyazi/yazi/releases/latest/download/yazi-x86_64-unknown-linux-gnu.zip
unzip yazi-x86_64-unknown-linux-gnu.zip
sudo mv yazi-x86_64-unknown-linux-gnu/yazi /usr/local/bin/其他方式
1. Cargo（需要 Rust）
cargo install --locked yazi-fm yazi-cli
1. Snap（classic 模式）
sudo snap install yazi --classic可选依赖（增强功能）
sudo apt install ffmpegthumbnailer ffmpeg p7zip-full jq poppler-utils fd-find ripgrep fzf imagemagickShell 集成（必须配置）
Yazi 退出后无法自动切换到当前目录，需要添加 shell wrapper。
Bash/Zsh
将以下代码加入 ~/.bashrc 或 ~/.zshrc：
function y() {
local tmp="$(mktemp -t "yazi-cwd.XXXXXX")"
yazi "$@" --cwd-file="$tmp"
if cwd="$(cat -- "$tmp")" && [ -n "$cwd" ] && [ "$cwd" != "$PWD" ]; then
cd -- "$cwd"
fi
rm -f -- "$tmp"
}使用：
y– 启动 Yaziq– 退出并切换到当前目录Q– 退出但不切换目录
核心快捷键
导航
| 快捷键 | 功能 |
|---|---|
j/k 或 ↓/↑ |
上下移动光标 |
h/l 或 ←/→ |
进入父目录/子目录 |
g |
跳转到顶部 |
G |
跳转到底部 |
/ |
搜索文件 |
n/N |
下一个/上一个搜索结果 |
文件操作
| 快捷键 | 功能 |
|---|---|
Space |
选择/取消选择当前文件 |
v |
进入可视模式（批量选择） |
y |
复制选中文件 |
x |
剪切选中文件 |
p |
粘贴 |
d |
删除（移到回收站） |
D |
永久删除 |
r |
重命名当前文件 |
Enter |
打开文件/进入目录 |
; |
执行 shell 命令 |
视图与标签
| 快捷键 | 功能 |
|---|---|
z |
排序选项菜单 |
Tab |
切换面板 |
t |
新建标签页 |
1-9 |
切换到对应标签页 |
[/] |
前/后一个标签页 |
其他
| 快捷键 | 功能 |
|---|---|
F1 或 ~ |
打开帮助菜单 |
q |
退出 |
? |
显示所有快捷键 |
配置文件
配置目录：~/.config/yazi/
主要配置文件
yazi.toml– 常规配置（界面、行为、性能）keymap.toml– 快捷键自定义theme.toml– 颜色主题
初始化配置
1. 生成默认配置文件
mkdir -p ~/.config/yazi
yazi --clear-cache # 首次运行自动生成配置自定义示例
编辑 ~/.config/yazi/keymap.toml：
[manager]
prepend_keymap = [
{ on = [ "<C-d>" ], exec = "remove --permanently", desc = "Ctrl+D 永久删除" },
{ on = [ "e" ], exec = "shell '$EDITOR $@'", desc = "用编辑器打开" },
]实用技巧
1. 性能优化
低配设备（如树莓派）：
编辑 ~/.config/yazi/yazi.toml：
[tasks]
micro_workers = 2 # 默认 5，降低并发
macro_workers = 4 # 默认 10高性能终端：
[preview]
image_delay = 0 # 降低图片预览延迟2. 网络文件管理
管理远程文件时禁用预览（避免下载）：
[preview]
max_width = 0
max_height = 03. 插件与主题
1. 安装插件管理器
git clone https://github.com/yazi-rs/plugins.git ~/.config/yazi/plugins
1. 浏览可用插件
https://github.com/yazi-rs/awesome-yazi4. 常见操作组合
- 批量重命名：
v选择多个文件 →r重命名 - 快速跳转： 安装
zoxide后可用z命令快速跳转 - 文件搜索：
/搜索 →n逐个定位 →Space选中
最佳实践
- 优先使用
ywrapper – 确保目录切换生效 - 安装可选依赖 – 解锁完整预览功能
- 熟记核心快捷键 –
hjkl（导航）、yxp（复制剪切粘贴）、Space（选择） - 自定义 keymap – 根据个人习惯调整快捷键
- 定期查看文档 – https://yazi-rs.github.io/docs/
故障排查
图片预览不工作
1. 检查依赖
which ffmpegthumbnailer
which convert # ImageMagick
1. 测试终端图片协议支持
yazi --clear-cacheShell wrapper 不生效
1. 确认函数已加载
type y
1. 重新加载配置
source ~/.bashrc # 或 ~/.zshrc