Neste artigo
O Que É YAML e Porquê Validá-lo
O YAML, que significa YAML Ain't Markup Language, é um formato de serialização de dados amigável para humanos utilizado extensivamente em ficheiros de configuração, pipelines de CI/CD, infraestrutura como código e troca de dados. A sua sintaxe baseada em indentação torna-o legível, mas também o torna altamente sensível a erros de espaçamento invisíveis a olho nu.
Validar o YAML antes da implantação é crítico porque até um único espaço mal posicionado ou um nível de indentação errado pode fazer com que uma configuração seja analisada de forma diferente da pretendida, ou falhe completamente na análise. Um ficheiro YAML com erros num manifesto Kubernetes, stack Docker Compose ou workflow do GitHub Actions pode derrubar serviços ou bloquear implantações.
Como Funciona o Validador de YAML
O validador analisa a sua entrada YAML e reporta erros de sintaxe com números precisos de linha e coluna para que possa corrigir problemas instantaneamente.
- Cole o seu YAML — introduza ou cole conteúdo YAML de qualquer tamanho e o validador analisa-o imediatamente no seu navegador
- Veja os detalhes do erro — se o YAML estiver mal formado, o validador realça a linha e coluna exatas onde o parser falhou, com uma mensagem de erro clara
- Valide a estrutura — para além da sintaxe, o validador verifica chaves duplicadas, tipos incorretos e outros problemas estruturais que possam causar comportamento inesperado
- Formate a saída — o YAML válido é automaticamente formatado com indentação consistente para que possa copiar uma versão limpa de volta para o seu projeto
Experimente gratuitamente — sem cadastro
Abrir Validador de YAML →Erros Comuns de YAML e Como Corrigi-los
A sintaxe YAML é enganadoramente simples, e vários padrões de erros surgem repetidamente em ficheiros de configuração do mundo real.
- Erros de indentação — o YAML utiliza espaços para aninhamento, e misturar tabulações com espaços ou usar níveis de indentação inconsistentes é a fonte mais comum de falhas de análise
- Caracteres especiais sem aspas — valores que contêm dois pontos, cardinais ou chavetas devem ser colocados entre aspas para evitar que o parser os interprete como sintaxe YAML
- Chaves duplicadas — o YAML permite chaves duplicadas ao mesmo nível, mas apenas o último valor é mantido, o que sobrescreve silenciosamente valores anteriores e causa erros difíceis de encontrar
Perguntas Frequentes
Qual é a diferença entre YAML e JSON?
O YAML é um superconjunto do JSON, o que significa que todo o documento JSON válido é também YAML válido. O YAML acrescenta funcionalidades como comentários, strings multi-linha, âncoras e aninhamento baseado em indentação que o tornam mais legível para humanos. O JSON é mais rigoroso e mais amplamente suportado por APIs, enquanto o YAML é preferido para ficheiros de configuração onde a legibilidade é importante.
Posso utilizar tabulações para indentação em YAML?
Não. A especificação YAML proíbe explicitamente caracteres de tabulação para indentação. Deve utilizar espaços, e o número de espaços por nível de indentação deve ser consistente dentro de um documento. A maioria dos editores pode ser configurada para inserir espaços quando pressiona a tecla Tab.
O validador suporta YAML multi-documento?
Sim. Os ficheiros YAML podem conter múltiplos documentos separados por um separador de três traços. O validador analisa cada documento independentemente e reporta erros com os números de linha corretos relativos ao ficheiro completo.