Yazi - 초고속 터미널 파일 관리자 치트시트

Yazi - 초고속 터미널 파일 관리자 치트시트

비동기 I/O를 기반으로 구축된 Rust로 작성된 초고속 터미널 파일 관리자. 이미지 미리보기, 대량 작업, Vim 스타일 키 바인딩, Lua 플러그인 시스템, ripgrep, fd, fzf 및 zoxide와의 통합을 제공합니다.

설치

플랫폼	명령어
macOS (Homebrew)	brew install yazi ffmpegthumbnailer poppler fd ripgrep fzf zoxide font-symbols-only-nerd-font
Arch Linux	sudo pacman -S yazi ffmpegthumbnailer poppler fd ripgrep fzf zoxide
Ubuntu/Debian	GitHub 릴리스에서 다운로드
Fedora/RHEL	sudo dnf install yazi
Windows (Scoop)	scoop install yazi
Windows (Winget)	winget install sxyazi.yazi
Cargo (모든 플랫폼)	cargo install --locked yazi-fm yazi-cli
Nix	nix-env -iA nixpkgs.yazi

선택적 의존성 (전체 기능용): ffmpegthumbnailer (비디오 썸네일), poppler (PDF 미리보기), fd, ripgrep, fzf, zoxide, ImageMagick, 7-Zip/unar.

실행: yazi 또는 yazi /path/to/dir 실행

탐색

키	설명
h	부모 디렉토리로 이동
l 또는 Enter	파일 열기 또는 디렉토리 진입
j	커서 아래로 이동
k	커서 위로 이동
J	커서 5줄 아래로 이동
K	커서 5줄 위로 이동
g g	첫 번째 항목으로 이동
G	마지막 항목으로 이동
H	히스토리에서 뒤로 이동
L	히스토리에서 앞으로 이동
~	홈 디렉토리로 이동
Backspace	부모 디렉토리로 이동
z	zoxide를 통한 이동 (퍼지 디렉토리 검색)
Z	fzf를 통한 이동

파일 작업

키	설명
o	기본 프로그램으로 선택한 파일 열기
O	대화형으로 파일 열기 (프로그램 선택)
y	선택한 파일 복사 (yank)
x	선택한 파일 잘라내기
p	복사/잘라낸 파일 붙여넣기
P	덮어쓰기와 함께 붙여넣기
d	선택한 파일을 휴지통으로 이동
D	선택한 파일 영구 삭제
a	새 파일 또는 디렉토리 생성 (디렉토리는 / 추가)
r	선택한 파일 이름 변경
c	처음에 커서를 두고 이름 변경
.	숨김 파일 표시 토글

선택

키	설명
Space	현재 항목의 선택 토글
v	비주얼 모드 진입 (범위 선택)
V	비주얼 모드 진입 (범위 선택 해제)
Ctrl+a	모든 항목 선택
Ctrl+r	역선택 (모두 토글)
Esc	선택 취소 / 비주얼 모드 종료

검색 및 필터링

키	설명
/	현재 디렉토리에서 검색
?	역방향 검색
n	다음 검색 일치로 이동
N	이전 검색 일치로 이동
f	현재 디렉토리 필터링 (일치하는 것만 표시)
s	하위 디렉토리 전체에서 fd로 파일 검색
S	ripgrep으로 파일 내용 검색

정렬

키	설명
,m	수정 시간으로 정렬
,M	수정 시간으로 정렬 (역순)
,c	생성 시간으로 정렬
,C	생성 시간으로 정렬 (역순)
,e	확장자로 정렬
,E	확장자로 정렬 (역순)
,a	알파벳순 정렬
,A	알파벳순 정렬 (역순)
,n	자연 정렬 (숫자 인식)
,N	자연 정렬 (역순)
,s	크기로 정렬
,S	크기로 정렬 (역순)
,r	무작위 정렬

탭

키	설명
t	새 탭 생성
1-9	번호로 탭 전환
[	이전 탭으로 전환
]	다음 탭으로 전환
{	이전 탭과 바꾸기
}	다음 탭과 바꾸기

대량 작업

키	설명
Space (여러 개에)	여러 파일 선택 후 y/x/d 사용
r	이름 변경 (선택 항목에서 대량 이름 변경)

대량 이름 변경 워크플로우

1. Space 또는 비주얼 모드 (v)로 파일 선택
2. r을 눌러 $EDITOR에서 대량 이름 변경 열기
3. 편집기에서 파일명 편집
4. 저장 및 닫기 — Yazi가 모든 이름 변경 적용

미리보기 시스템

Yazi는 많은 파일 유형에 대한 내장 미리보기를 제공합니다:

파일 유형	미리보기
이미지 (PNG, JPG 등)	인라인 이미지 미리보기 (지원되는 터미널에서)
비디오	썸네일 미리보기 (ffmpegthumbnailer 필요)
PDF	첫 페이지 미리보기 (poppler 필요)
텍스트/코드	구문 강조 미리보기
아카이브	내용 목록
디렉토리	자식 파일 목록

이미지 미리보기 지원 터미널: Kitty, iTerm2, WezTerm, Ghostty, foot, Konsole, Windows Terminal, VSCode, Warp.

설정

설정 파일 위치

파일	용도
~/.config/yazi/yazi.toml	일반 설정
~/.config/yazi/keymap.toml	사용자 정의 키 바인딩
~/.config/yazi/theme.toml	색상 및 스타일
~/.config/yazi/init.lua	플러그인 초기화

주요 설정 (yazi.toml)

[manager]
show_hidden = false          # 기본적으로 dotfiles 표시
sort_by = "natural"          # natural, alphabetical, size, modified, created, extension
sort_dir_first = true        # 파일보다 디렉토리 먼저
linemode = "size"            # 파일명 옆에 표시되는 정보: size, mtime, permissions, none

[preview]
max_width = 1000             # 최대 미리보기 너비
max_height = 1000            # 최대 미리보기 높이
image_quality = 75           # 썸네일 JPEG 품질

[opener]
# 사용자 정의 파일 오프너
edit = [{ run = 'nvim "$@"', block = true }]
open = [{ run = 'open "$@"' }]  # macOS: open, Linux: xdg-open

셸 통합

종료 시 디렉토리 변경 (권장)

셸 설정에 추가하여 Yazi 종료 시 마지막으로 방문한 디렉토리로 이동:

Bash/Zsh:

function y() {
  local tmp="$(mktemp -t "yazi-cwd.XXXXXX")" cwd
  yazi "$@" --cwd-file="$tmp"
  if cwd="$(command cat -- "$tmp")" && [ -n "$cwd" ] && [ "$cwd" != "$PWD" ]; then
    builtin cd -- "$cwd"
  fi
  rm -f -- "$tmp"
}

Fish:

function y
  set tmp (mktemp -t "yazi-cwd.XXXXXX")
  yazi $argv --cwd-file="$tmp"
  if set cwd (command cat -- $tmp); and [ -n "$cwd" ]; and [ "$cwd" != "$PWD" ]
    builtin cd -- "$cwd"
  end
  rm -f -- $tmp
end

플러그인 시스템

# 플러그인 설치
ya pack -a owner/plugin-name

# 모든 플러그인 업데이트
ya pack -u

# 설치된 플러그인 나열
ya pack -l

인기 플러그인: git 상태 통합, 아카이브 추출, 이미지 조작, 사용자 정의 미리보기어.

일반적인 워크플로우

# 특정 디렉토리에서 실행
yazi ~/projects

# 이미지 미리보기로 빠른 파일 탐색
yazi ~/photos

# 대량 이름 변경 워크플로우
# 1. 디렉토리로 이동
# 2. Space 또는 v로 파일 선택
# 3. r을 눌러 편집기에서 대량 이름 변경

다른 파일 관리자와의 비교

기능	Yazi	ranger	lf	nnn
언어	Rust	Python	Go	C
비동기 I/O	예	아니오	아니오	아니오
이미지 미리보기	기본	예	플러그인	플러그인
플러그인 시스템	Lua	Python	셸	셸
속도	매우 빠름	보통	빠름	매우 빠름
대량 이름 변경	내장	내장	외부	외부
Vim 키 바인딩	예	예	예	아니오

리소스

• 공식 웹사이트
• 문서
• GitHub 저장소
• 플러그인 디렉토리