yazi Cheatsheet

0.4

Atalhos de teclado essenciais para o gerenciador de arquivos de terminal yazi

Português: 2026-03-29

Se você estava usando ranger ou lf para navegar arquivos no terminal, yazi é o upgrade que você não sabia que precisava. Escrito em Rust (porque claro), yazi é um gerenciador de arquivos de terminal rápido o suficiente para fazer você esquecer que não está usando um app nativo. Estamos falando de I/O assíncrono em todo lugar — carregamento de diretórios, previews de arquivos, renderização de imagens — nada bloqueia a UI. Nunca.

O que diferencia o yazi do ranger? Velocidade, principalmente. Ranger é baseado em Python e começa a engasgar em diretórios grandes. lf é mais ágil mas minimalista ao extremo — você acaba configurando tudo manualmente. Yazi atinge o ponto ideal: vem com tudo incluído — preview de imagens embutido (sim, no terminal via protocolos Kitty/iTerm2/Sixel), renomeação em massa, sistema de plugins em Lua e integração nativa com ferramentas como fzf, fd e ripgrep. Ele usa a mesma navegação vim-style h/j/k/l que você já conhece, então a memória muscular se transfere instantaneamente.

O layout de três painéis em colunas Miller mostra diretório pai, diretório atual e um preview ao vivo do que estiver selecionado — código com syntax highlighting, imagens renderizadas inline, arquivos listados. Suporte a abas significa que você pode alternar entre múltiplos diretórios sem abrir panes de terminal extras. E o modo de seleção visual permite escolher arquivos entre diretórios antes de aplicar operações em massa. Pense nele como o cockpit de usuário avançado do seu sistema de arquivos.

Navegação
h
Ir para o diretório pai
l
Entrar no diretório / abrir arquivo
j
Mover cursor para baixo
k
Mover cursor para cima
J
Avançar preview 5 linhas para baixo
K
Avançar preview 5 linhas para cima
gg
Pular para o primeiro arquivo
G
Pular para o último arquivo
Enter
Abrir arquivo selecionado
Backspace
Ir para o diretório pai (alternativa)
~
Pular para o diretório home
Ctrl+u
Rolar meia página para cima
Ctrl+d
Rolar meia página para baixo
Operações com Arquivos
y
Copiar (yank) arquivos selecionados
x
Recortar (mover) arquivos selecionados
p
Colar arquivos copiados no diretório atual
P
Colar arquivos copiados (sobrescrever existentes)
d
Enviar arquivos selecionados para a lixeira
D
Deletar permanentemente arquivos selecionados
a
Criar novo arquivo ou diretório (adicione / no final para diretório)
r
Renomear arquivo selecionado
.
Alternar arquivos ocultos
z
Pular com zoxide (se instalado)
Z
Pular com fzf via zoxide
u
Desfazer última operação de cópia/exclusão
Seleção
Space
Alternar seleção no arquivo atual e mover para baixo
v
Entrar no modo visual (selecionar intervalo)
V
Entrar no modo visual de desseleção (desselecionar intervalo)
Ctrl+a
Selecionar todos os arquivos no diretório atual
Ctrl+r
Inverter seleção no diretório atual
Escape
Cancelar seleção / sair do modo visual
Preview
J
Rolar painel de preview para baixo
K
Rolar painel de preview para cima
w
Alternar painel de preview ligado/desligado
Abas
t
Criar uma nova aba com o diretório atual
Ctrl+c
Fechar aba atual
1-9
Mudar para aba por número
[
Mudar para aba anterior
]
Mudar para próxima aba
Busca e Filtro
/
Buscar por nome de arquivo (para frente)
?
Buscar por nome de arquivo (para trás)
n
Pular para próxima correspondência de busca
N
Pular para correspondência de busca anterior
f
Filtrar arquivos no diretório atual
s
Busca interativa com fd
S
Buscar conteúdo de arquivos com ripgrep
Integração com Shell
;
Executar um comando shell (bloqueante)
:
Executar um comando shell (não-bloqueante/async)
q
Sair do yazi
Q
Sair do yazi e cd para o diretório atual

Dicas

Use Q (maiúsculo) em vez de q para sair — ele imprime o caminho do diretório atual para que seu shell possa fazer cd para ele. Combine com um alias de shell como function y() { local tmp; tmp=$(yazi "$@" --cwd-file=/dev/stdout); [ -n "$tmp" ] && cd "$tmp"; } para aterrissar perfeitamente onde você parou.

Yazi tem zoxide integrado. Pressione z para fazer um salto fuzzy para qualquer diretório que você já visitou sem sair do gerenciador de arquivos. É como cd com memória fotográfica.

Pressionando a para criar arquivos? Termine o nome com / para criar um diretório. Digite src/components/ e yazi cria o caminho aninhado completo. Sem necessidade de mkdir -p.

Você pode selecionar arquivos em múltiplos diretórios. Selecione alguns arquivos em um diretório, navegue para outro, selecione mais, depois p para colar todos no destino. Yazi lembra suas seleções durante a navegação.

Use S (maiúsculo) para buscar conteúdo de arquivos com ripgrep diretamente dentro do yazi. É como ter rg --files-with-matches integrado ao seu gerenciador de arquivos — selecione uma correspondência e pule direto para ela.

A renomeação em massa é incrivelmente poderosa: selecione arquivos, depois use a tecla r em uma multi-seleção para abri-los no seu $EDITOR como uma lista. Edite os nomes como quiser — regex, buscar/substituir, o que seu editor suportar — e salve. Yazi aplica todas as renomeações de uma vez.

Defina $YAZI_FILE_ONE para usar um banco de dados file(1) personalizado para detecção de MIME se seus previews não estão funcionando como esperado. Yazi depende fortemente de tipos MIME precisos para escolher o previewer correto.

Related Tools