简介

Yazi（“鸭子”）是一款 Rust 写的终端文件管理器。它采用异步 I/O 架构，即使目录中包含数千个文件也能保持流畅操作。Yazi 的操作逻辑借鉴了 Vim，默认使用单键快捷键，并支持图像预览、模糊搜索、批量重命名和多标签页。

安装与启动

# macOS (Homebrew)
brew install yazi

# Arch Linux
sudo pacman -S yazi

# Cargo (编译安装)
cargo install yazi-fm

# 直接启动
yazi

# 启动并跳转到指定目录
yazi /path/to/project

“NOTE

提示：Yazi 支持 Kitty、iTerm2 等终端的图像协议，可在终端内直接预览图片、视频缩略图和 PDF。若终端不支持，会回退为 ASCII 艺术形式。

核心快捷键速查

Yazi 默认把所有操作都绑在单键上，下面按场景分组：

导航

“NOTE

还支持 Vim 风格行跳转：如 5G 跳转到第 5 行。

文件操作

“NOTE

选中多个文件后按 r，会调用外部编辑器批量重命名。

选择

搜索与跳转

“NOTE

搜索后按 n / N 跳转下一个/上一个匹配项。

其他常用

Shell 集成：退出时自动切换目录

Yazi 退出后 Shell 仍停留在启动时的目录。加一个 Shell 包装函数，就能让它切到当时浏览的目录。

在 ~/.zshrc（或 ~/.bashrc）中添加：

function yy() {
  local tmp
  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"
}

进阶功能

图像与媒体预览

将光标停留在图片（.jpg、.png）、视频或 PDF 文件上，右侧预览面板会自动显示内容。支持 Kitty、iTerm2、Sixel 等图形协议。

多标签页与分栏

Yazi 支持多标签页（Tab 切换）和分栏视图，方便在不同目录之间对比和移动文件。

Lua 插件系统

Yazi 用 Lua 脚本扩展功能，也可以直接装社区插件。

自定义按键绑定

修改配置文件 keymap.toml（位于 ~/.config/yazi/）即可自定义快捷键。例如，将 o 键绑定为创建文件：

1
[manager]
2
o = { exec = "shell", args = ["touch"] }