Yazi 终端文件管理器使用指南

简介

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

安装与启动

不同平台安装命令如下：

1
# macOS (Homebrew)
2
brew install yazi
3

4
# Arch Linux
5
sudo pacman -S yazi
6

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

启动方式非常简单：

1
# 直接启动
2
yazi
3

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

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

核心快捷键速查

快捷键是 Yazi 的核心操作方式，以下按使用场景分类整理：

导航

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

文件操作

选中多文件后按 r 会调用外部编辑器进行批量重命名，非常高效。

选择

搜索与跳转

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

其他常用

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

Yazi 默认退出后 Shell 仍停留在启动时的目录。通过配置 Shell 包装函数，可以实现“退出 Yazi 后自动切换到当时浏览的目录”。

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

1
function yy() {
2
  local tmp
3
  tmp="$(mktemp -t "yazi-cwd.XXXXXX")"
4
  yazi "$@" --cwd-file="$tmp"
5
  if cwd="$(cat -- "$tmp")" && [ -n "$cwd" ] && [ "$cwd" != "$PWD" ]; then
6
    cd -- "$cwd"
7
  fi
8
  rm -f -- "$tmp"
9
}

之后使用 yy 命令启动 Yazi，退出时终端会自动切换到 Yazi 最后浏览的目录。

进阶功能

图像与媒体预览

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

多标签页与分栏

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

Lua 插件系统

Yazi 通过 Lua 脚本扩展功能，可安装社区插件实现自定义功能。

自定义按键绑定

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

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

常用指令速记

Yazi 默认内置了完善的文件操作功能（创建、删除、重命名等），大多数场景无需自定义快捷键就能高效工作。