dust - Folha de Referência do Analisador de Uso de Disco Intuitivo

Uma versão mais intuitiva do du (Disk Usage) escrita em Rust. Exibe o uso de disco com gráficos de barras visuais, facilitando identificar o que está consumindo espaço de relance.

Instalação

Plataforma	Comando
macOS (Homebrew)	`brew install dust`
Ubuntu/Debian	`sudo apt install du-dust`
Arch Linux	`sudo pacman -S dust`
Fedora/RHEL	`sudo dnf install dust`
Windows (Scoop)	`scoop install dust`
Windows (Chocolatey)	`choco install dust`
Cargo (Todas as plataformas)	`cargo install du-dust`
Snap	`sudo snap install dust`
Conda	`conda install -c conda-forge dust`
Nix	`nix-env -iA nixpkgs.du-dust`

Comandos Básicos

Comando	Descrição
`dust`	Mostrar uso de disco do diretório atual com gráfico de barras
`dust /path/to/dir`	Analisar um diretório específico
`dust dir1 dir2`	Comparar uso de disco de múltiplos diretórios
`dust -n 10`	Mostrar as 10 maiores entradas
`dust -n 30`	Mostrar as 30 maiores entradas
`dust -d 2`	Limitar exibição a 2 níveis de diretório de profundidade
`dust -d 1`	Mostrar apenas filhos imediatos (visão geral)
`dust -r`	Inverter ordem de saída (menor primeiro)
`dust -p`	Mostrar caminhos completos para cada entrada
`dust -s`	Mostrar tamanho aparente em vez de uso de disco

Opções de Filtragem

Comando	Descrição
`dust -D`	Mostrar apenas diretórios (sem arquivos individuais)
`dust -F`	Mostrar apenas arquivos (sem diretórios)
`dust -i`	Ocultar arquivos e diretórios ocultos
`dust -x`	Permanecer no mesmo sistema de arquivos (não cruzar pontos de montagem)
`dust -X node_modules`	Ignorar entradas nomeadas “node_modules”
`dust -X ".git"`	Ignorar diretórios `.git`
`dust -e "\.log$"`	Incluir apenas arquivos que correspondem ao padrão regex
`dust -v "\.tmp$"`	Excluir arquivos que correspondem ao padrão regex
`dust -z 1M`	Mostrar apenas entradas maiores que 1 MB
`dust -z 100K`	Mostrar apenas entradas maiores que 100 KB
`dust -t`	Agrupar resultados por tipo/extensão de arquivo
`dust -f`	Contar número de arquivos em vez de uso de disco

Formatação de Saída

Comando	Descrição
`dust -b`	Remover porcentagens e barras ASCII (saída simples)
`dust -B`	Mover barras de porcentagem para o lado direito
`dust -c`	Saída monocromática (sem cores)
`dust -C`	Forçar saída colorida (mesmo ao usar pipes)
`dust -R`	Modo leitor de tela (sem barras, adiciona coluna de profundidade)
`dust -j`	Saída em formato JSON
`dust --skip-total`	Não mostrar a linha total no topo

Opções de Formato de Tamanho

Comando	Descrição
`dust -o si`	Unidades SI (KB, MB, GB — potências de 1000)
`dust -o b`	Mostrar tamanhos em bytes
`dust -o kb`	Mostrar tamanhos em kilobytes
`dust -o kib`	Mostrar tamanhos em kibibytes (1024)
`dust -o mb`	Mostrar tamanhos em megabytes
`dust -o mib`	Mostrar tamanhos em mebibytes (1024²)
`dust -o gb`	Mostrar tamanhos em gigabytes
`dust -o gib`	Mostrar tamanhos em gibibytes (1024³)

Opções Avançadas

Comando	Descrição
`dust -L`	Seguir links simbólicos
`dust -P`	Desabilitar indicador de progresso
`dust --collapse folder_name`	Manter pasta especificada recolhida na saída
`dust --files-from=list.txt`	Ler caminhos de um arquivo separado por novas linhas
`dust --files0-from=list.txt`	Ler caminhos de um arquivo separado por NUL

Fluxos de Trabalho Comuns

# Visão geral rápida: o que está consumindo espaço em disco?
dust -d 1

# Encontrar os maiores arquivos em um projeto
dust -F -n 20

# Analisar diretório home, ignorando caches
dust -X ".cache" -X "node_modules" ~

# Comparar dois diretórios lado a lado
dust ~/projects ~/downloads

# Saída legível por máquina para scripts
dust -j /var/log

# Descobrir o que está usando espaço na raiz, apenas mesmo sistema de arquivos
sudo dust -x -d 2 /

# Agrupar por tipo de arquivo para ver quais extensões usam mais espaço
dust -t -n 20

# Mostrar apenas diretórios maiores que 100MB
dust -D -z 100M

Lendo a Saída

dust exibe uma saída em formato de árvore com barras visuais:

 5.0G   ┌── videos                │████████████████████████████████ │  50%
 2.5G   ├── photos                │████████████████                 │  25%
 1.5G   ├── documents             │██████████                       │  15%
 500M   ├── music                 │███                              │   5%
 500M   ├── downloads             │███                              │   5%
10.0G ┌─┴ home                    │████████████████████████████████ │ 100%

Coluna de tamanho: Tamanho total do diretório e seu conteúdo
Marcadores de árvore: Mostram relacionamentos pai-filho (┌──, ├──, └──)
Gráfico de barras: Proporção visual de cada entrada
Porcentagem: Participação do tamanho total do diretório pai

Comparação com du

Recurso	du	dust
Barras visuais	Não	Sim
Saída colorida	Não	Sim
Ordenação padrão	Não	Por tamanho
Agrupamento por tipo de arquivo	Não	Sim (`-t`)
Saída JSON	Não	Sim (`-j`)
Filtragem por regex	Não	Sim (`-e`, `-v`)
Filtro de tamanho mínimo	Não	Sim (`-z`)
Velocidade	Rápido	Rápido (Rust)

Recursos

Repositório GitHub