// formatters
YAML Key Sorter.
Recursively sort YAML keys alphabetically while preserving arrays and scalars. Useful for diff-friendly files.
YAML input
Sorted output
Perguntas frequentes
Ordenar quebra minhas âncoras?
Não, a ordenação preserva âncoras e referências corretamente.
Preserva comentários?
Sim, os comentários permanecem em sua posição original.
Posso desfazer a ordenação?
Sim, você pode restaurar a ordem original.
Por que ordenar chaves YAML
Ordenar chaves YAML torna os arquivos mais fáceis de ler e manter. Quando as chaves estão em ordem alfabética, é mais rápido encontrar propriedades específicas, especialmente em arquivos grandes.
Para diffs e versionamento, arquivos com chaves ordenadas produzem mudanças mais limpas e menores. Sem ordenação, reordenar manualmente uma chave pode gerar diffs desnecessários que obscurecem mudanças reais.
Em configurações padrão, como package.json, pubspec.yaml ou arquivos de ambiente, a ordenação alfabética é uma convenção amplamente adotada que melhora a colaboração em equipe.
Como funciona a ordenação
A ordenação é feita recursivamente em todos os níveis do YAML. Chaves raiz e chaves aninhadas são ordenadas separadamente, mantendo a estrutura de aninhamento intacta.
A ordenação respeita a estrutura do YAML: listas, mapas e valores escalares são tratados adequadamente. Valores que são mapas recursivos também têm suas chaves internas ordenadas.
A ferramenta preserva a formatação original do YAML, incluindo indentação e estilo de aspas. Apenas a ordem das chaves é alterada, sem modificar o conteúdo dos valores.
Quando ordenar chaves
Use ordenação quando trabalhar com arquivos de configuração que são frequentemente editados por múltiplas pessoas, como docker-compose.yml ou config.yml.
Ordene para melhorar a legibilidade de arquivos YAML grandes, especialmente quando eles contêm muitas chaves no mesmo nível.
Evite ordenar quando a ordem das chaves é semanticamente significativa, como em arquivos YAML que definem sequências de execução ou ordem de plugins.