macOS（通过 Homebrew）#

首先确保已安装 Homebrew，若未安装可运行：

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后直接安装 Yazi：

1
brew install yazi

安装完成后检查版本：

1
yazi --version

Linux（各发行版）#

Arch Linux / Manjaro：

1
sudo pacman -S yazi

Ubuntu / Debian（需先安装 Cargo）：

1
cargo install --locked yazi-fm

Fedora：

1
sudo dnf install yazi

Windows（通过 Scoop 或 Cargo）#

Scoop：

1
scoop install yazi

Cargo（需先安装 Rust）：

1
cargo install --locked yazi-fm

启动 Yazi#

在终端中输入：

1
yazi

即可进入文件管理界面。Yazi 默认显示三列：

• 左侧：父级目录
• 中间：当前目录文件列表
• 右侧：文件预览（支持文本、图片、代码高亮等）

常用快捷键#

文件预览#

Yazi 支持多种文件类型的预览：

• 文本文件：自动高亮代码（需安装 bat 或 highlight）
• 图片：终端内预览（需 ueberzugpp 或 Kitty/WezTerm）
• PDF / 视频：显示元信息
• 压缩包：列出内部文件

配置文件路径#

Yazi 的配置文件位于：

• macOS / Linux：~/.config/yazi/
• Windows：%APPDATA%\yazi\config\

主要配置文件：

• yazi.toml：核心配置
• keymap.toml：自定义键位
• theme.toml：主题配色

开启图片预览（推荐）#

安装 ueberzugpp（跨终端兼容）：

macOS：

1
brew install jstkdng/programs/ueberzugpp

Arch Linux：

1
yay -S ueberzugpp

然后在 yazi.toml 中启用：

1
[preview]
2
image_method = "ueberzug"

集成 zoxide（快速跳转）#

安装 zoxide：

1
brew install zoxide  # macOS
2
cargo install zoxide  # 跨平台

在 shell 配置中添加初始化（~/.zshrc 或 ~/.bashrc）：

1
eval "$(zoxide init zsh)"  # 或 bash

在 Yazi 中按 z 后输入目录名即可快速跳转。

自定义键位示例#

编辑 ~/.config/yazi/keymap.toml，例如将 dd 映射为删除：

1
[[manager.prepend_keymap]]
2
on = [ "d", "d" ]
3
exec = "remove"
4
desc = "Delete selected files"

批量重命名#

1. 用 Space 选中多个文件
2. 按 r 进入批量重命名模式
3. 在编辑器中修改文件名（支持正则替换）
4. 保存退出即可批量应用

书签与快速跳转#

按 m + 字母 可标记当前目录为书签，之后按 ' + 字母 快速返回。

在 Yazi 中执行 Shell 命令#

按 : 进入命令模式，输入 Shell 命令，例如：

1
:!git status

集成到 Vim/Neovim#

在 Neovim 中可通过插件 yazi.nvim 集成：

1
use 'mikavilpas/yazi.nvim'

配置快捷键打开 Yazi 浏览文件。