Yazi 终端文件管理器入门指南

Yazi 是什么

Yazi 是一款运行在终端中的现代化文件管理器，强调键盘操作、快速响应和文件预览能力。对于长期使用命令行的用户来说，它可以把目录浏览、文件切换、预览和基础管理整合到一个统一界面中。

如果你平时习惯使用终端完成开发、部署或日常文件整理，那么 Yazi 往往会比单纯依赖 ls、cd 和 find 更直观，也更高效。

一句话理解：Yazi 是一个适合键盘流用户的现代终端文件管理器。

为什么使用 Yazi

在终端中浏览目录时，传统方式通常依赖反复输入命令，例如查看目录、切换路径、搜索文件、确认内容等。目录层级一深，操作就容易变得零散。

Yazi 的优势主要体现在以下几个方面：

1. 浏览目录更高效

它提供了更直观的目录浏览方式，能够快速进入子目录、返回上级目录，并在大量文件中持续移动而不用频繁敲命令。

2. 预览能力更强

除了查看文件名，你还可以直接预览文本内容。在依赖工具齐全的情况下，还能预览图片、PDF 或视频缩略图。

3. 更适合键盘流工作方式

Yazi 的大部分操作都围绕键盘完成，适合习惯命令行、希望减少鼠标切换的人。

4. 适合日常开发与运维场景

无论是查看项目目录、清理下载文件，还是在服务器上快速定位配置文件，Yazi 都比纯命令行浏览更顺手。

Yazi 的核心特点

Yazi 之所以受到很多终端用户欢迎，主要有以下特点：

• 启动速度快，目录切换流畅
• 支持文本与多种文件类型预览
• 键盘驱动，操作连贯
• 支持自定义配置和快捷键调整
• 能与常见搜索、跳转、预览类工具配合使用

它并不是为了替代所有图形化文件管理器，而是为了在终端环境中提供一种更高效的文件浏览和管理方式。

安装 Yazi

不同平台的安装方式略有差异，下面列出一些常见方法。

macOS

 
 
bash
brew install yazi

如果你希望获得更完整的搜索、预览和跳转体验，还可以安装一些常见依赖：

 
 
bash
brew install ffmpegthumbnailer sevenzip jq poppler fd ripgrep fzf zoxide imagemagick

Arch / Manjaro

 
 
bash
sudo pacman -S yazi

如需完整体验，也可以按需安装相关依赖工具。

Ubuntu / Debian

在某些发行版的软件源中，Yazi 版本可能不是最新。如果你希望使用较新的版本，可以优先查看官方 release、包管理社区仓库，或者使用 Rust 工具链安装。

验证安装

安装完成后，可以执行：

 
 
bash
yazi --version

如果输出了版本号，说明 Yazi 已经可用了。

快速开始

Yazi 的启动方式很直接。

打开当前目录

 
 
bash
yazi

打开指定目录

 
 
bash
yazi .
yazi ~/Downloads

退出 Yazi

按下：

 
 
bash
q

初次进入后先做什么

第一次打开时，不需要急着记住所有快捷键。先熟悉以下几个动作即可：

• 上下移动光标
• 进入目录或打开文件
• 返回上级目录
• 退出程序

只要先掌握这四个操作，基本就能开始日常使用。

基本导航操作

Yazi 的许多操作都延续了终端工具常见的键位风格。

上下移动

 
 
bash
j / k

用于在文件列表中上下移动。

进入目录或打开文件

 
 
bash
l
Enter

如果当前选中的是目录，则进入目录；如果是文件，则按配置方式打开或进入预览。

返回上级目录

 
 
bash
h

用于回到上一级目录。

跳到开头和结尾

 
 
bash
g
G

• g：跳到列表开头
• G：跳到列表结尾

常见文件操作

Yazi 不只是一个浏览器，也支持一套比较完整的基础文件管理操作。下面这些内容基于官方默认 keymap，总体上比较稳定，但不同版本或自定义配置下仍可能略有差异。

选择与可视模式

 
 
bash
<Space>
v
V
Ctrl+a
Ctrl+r
Esc

• <Space>：切换当前文件的选中状态，并向下移动一项
• v：进入可视选择模式
• V：进入取消式可视模式
• Ctrl+a：全选
• Ctrl+r：反选
• Esc：退出可视模式、清除选择或取消搜索

复制、剪切、粘贴与链接

 
 
bash
y
x
p
P
-
_
Ctrl+-
Y

• y：复制选中项
• x：剪切选中项
• p：粘贴
• P：强制粘贴，目标已存在时覆盖
• -：为已复制文件创建绝对路径软链接
• _：为已复制文件创建相对路径软链接
• Ctrl+-：创建硬链接
• Y：取消当前复制/剪切状态

删除、创建、重命名

 
 
bash
d
D
a
r

• d：将选中项移到回收站或执行普通删除
• D：永久删除
• a：创建文件；如果名称以 / 结尾则创建目录
• r：重命名当前文件或选中项

打开文件与预览相关操作

 
 
bash
o
O
Enter
Tab
J / K

• o 或 Enter：打开当前文件或目录
• O 或 Shift+Enter：以交互方式打开文件
• Tab：聚焦或查看当前文件的 spot 信息
• J / K：在预览区域中向下或向上滚动

执行命令与显示隐藏文件

 
 
bash
;
:
.

• ;：执行 shell 命令（交互模式）
• :：执行 shell 命令，并阻塞直到命令结束
• .：切换是否显示隐藏文件

搜索、筛选与跳转

当目录内容很多时，搜索和跳转会明显提高效率。

查找与过滤

 
 
bash
f
/
?
n
N
Ctrl+s

• f：过滤当前目录文件
• /：向后查找文件
• ?：向前查找文件
• n：跳到下一个匹配项
• N：跳到上一个匹配项
• Ctrl+s：取消当前搜索

借助外部工具搜索

 
 
bash
s
S
z
Z

• s：通过 fd 按文件名搜索
• S：通过 ripgrep 按内容搜索
• z：通过 fzf 快速跳转文件或目录
• Z：通过 zoxide 快速跳转目录

快速跳转目录

 
 
bash
gh
gc
gd
g<Space>
gf
H
L

• gh：跳转到家目录
• gc：跳转到 ~/.config
• gd：跳转到 ~/Downloads
• g<Space>：交互式跳转目录
• gf：跟随当前软链接
• H：回到上一个目录
• L：前进到下一个目录

配合外部工具增强体验

在一些环境中，Yazi 的搜索、预览和跳转能力可以借助外部工具得到增强，例如：

• fd
• ripgrep
• fzf
• zoxide
• jq
• poppler
• ffmpegthumbnailer
• imagemagick

这些工具并不是必须项，但在配置完整后，整体体验通常会更好。

文件预览能力

Yazi 的一个明显优势，就是它在终端环境下提供了不错的文件预览体验。

文本文件预览

对于代码、配置文件、日志、Markdown 文档等文本内容，通常可以直接预览，这在快速确认文件内容时非常方便。

图片、PDF 与媒体文件预览

在安装了相关依赖之后，Yazi 往往还能支持：

• 图片预览
• PDF 预览
• 视频缩略图预览

为什么有些文件无法预览

如果你发现某些文件不能正常预览，常见原因通常有：

• 缺少对应依赖工具
• 当前终端环境能力有限
• 远程环境不支持完整的图像或媒体预览能力

因此，Yazi 的预览体验很大程度上取决于你的终端环境和依赖是否齐全。

常用快捷键速查表

下面是一份更完整的默认快捷键速查表：

基本导航

选择与文件操作

搜索、过滤与跳转

视图、命令与辅助功能

标签页操作

排序与显示模式

如果你刚开始接触 Yazi，优先掌握导航、打开、复制/剪切/粘贴、搜索、执行命令和显示隐藏文件这几个动作就已经很够用了。

配置文件与基础自定义

Yazi 支持通过配置文件进行个性化调整。

配置目录

通常可以在以下位置找到配置目录：

 
 
bash
~/.config/yazi/

常见配置文件

配置目录中常见的文件包括：

• yazi.toml
• keymap.toml
• theme.toml

可以调整哪些内容

常见的自定义方向包括：

• 主题与配色
• 快捷键映射
• 排序方式
• 是否显示隐藏文件
• 文件打开行为

如果你是第一次使用 Yazi，建议先用默认配置熟悉基本操作，再根据自己的习惯逐步调整。

适合哪些使用场景

Yazi 很适合以下几类场景：

1. 浏览项目目录

在开发项目中查看目录结构、快速确认文件位置时，比反复使用 ls 和 cd 更直观。

2. 服务器文件管理

在远程环境下浏览配置文件、日志目录或部署目录时，操作体验通常会更连贯。

3. 下载目录或资料整理

面对杂乱文件时，使用 Yazi 进行浏览、筛选和移动会更高效。

4. 键盘流终端工作方式

如果你希望尽量减少鼠标切换，保持连续的终端操作节奏，Yazi 会比较适合。

使用建议

如果你是第一次接触终端文件管理器，可以按下面的节奏上手：

1. 先学会 j、k、h、l、q
2. 再掌握复制、剪切、粘贴
3. 然后熟悉搜索和预览
4. 最后再考虑主题和快捷键配置

不要一开始就陷入复杂配置。先把默认功能用顺手，通常会更容易建立自己的使用习惯。

总结

Yazi 并不是为了完全替代图形化文件管理器，而是为终端环境提供一种更高效、更现代的文件浏览和管理方式。

它把目录浏览、文件预览和基础文件操作整合到一个统一界面中，对于长期使用命令行的人来说，确实能够明显提升文件处理效率。

如果你平时经常在终端中浏览目录、查找文件、查看内容，或者希望建立更稳定的键盘流工作方式，那么 Yazi 是一款非常值得尝试的工具。