Convenções de nomes de arquivo
Não existe uma única convenção "correta" — mas as escolhas abaixo funcionam bem em diferentes sistemas operacionais, ferramentas e anos de uma pasta em constante crescimento.
Por que os nomes de arquivo importam
Um bom nome de arquivo é uma pequena documentação: diz o que é o arquivo sem precisar abri-lo, ordena-se de forma sensata junto a arquivos relacionados e sobrevive a ser copiado entre Windows, macOS e um servidor web sem quebrar.
Espaços versus hífens e sublinhados
Hífens (foto-produto.jpg) são a opção padrão mais segura: legíveis, compatíveis com URLs e nunca confundidos com um caractere de escape. Sublinhados funcionam quase tão bem. Espaços são a opção mais arriscada: algumas ferramentas e URLs os codificam como "%20" ou simplesmente falham com eles.
Nomes de arquivo em minúsculas
macOS e Windows tratam nomes de arquivo sem diferenciar maiúsculas de minúsculas por padrão, mas servidores Linux, não: "Foto.jpg" e "foto.jpg" são arquivos diferentes lá. Usar minúsculas em tudo evita completamente essa incompatibilidade.
Caracteres especiais
Evite < > : " / \ | ? * e caracteres de controle — são inválidos no Windows e causam problemas em URLs e em linhas de comando mesmo onde o sistema de arquivos os permite. Letras acentuadas (é, ü, ñ) são válidas, mas vale a pena normalizá-las (café → cafe) para máxima compatibilidade.
Tamanho do nome de arquivo
Mantenha os nomes de arquivo abaixo de cerca de 255 caracteres, e na prática bem mais curtos. Nomes longos costumam ser sintoma de espremer metadados dentro do nome — um padrão de nomenclatura com campos claros cumpre melhor essa função.
Numeração sequencial
Preencha os números com zeros à esquerda (001, 002… não 1, 2) para que os arquivos se ordenem corretamente ao passar de nove ou noventa e nove itens. Três dígitos cobrem confortavelmente a maioria dos lotes.
Datas em nomes de arquivo
Use a ordem ISO 8601 — AAAA-MM-DD — para que os nomes de arquivo se ordenem cronologicamente como texto simples: relatorio-2026-03-01.pdf se ordena corretamente ao lado de relatorio-2026-04-12.pdf sem nenhum tratamento especial.
Nomenclatura de versões
Prefira um marcador de versão explícito e ordenável — contrato-v2.pdf ou contrato-2026-03-01.pdf — em vez de "final", "final final" ou "final v2", que não trazem nenhuma ordenação confiável.
Nomenclatura de imagens
Combine um nome base descritivo com numeração sequencial: produto-camisa-azul-001.jpg. Nomes descritivos também ajudam no SEO de imagens, já que os mecanismos de busca leem o nome do arquivo.
Nomenclatura de arquivos de produto
Inclua o identificador estável que seus sistemas já usam — um SKU ou ID de produto — junto a um nome legível: sku-48213-camisa-azul.jpg mantém os arquivos rastreáveis a um catálogo mesmo depois de um produto ser renomeado.
Nomenclatura de documentos
Um padrão como 2026-03-01-fatura-acme-corp.pdf coloca a data primeiro para facilitar a ordenação e mantém o tipo de documento e a parte envolvida identificáveis à primeira vista, sem abrir o arquivo.
Nomenclatura para desenvolvedores
Use a convenção de maiúsculas/minúsculas que sua ferramenta espera — kebab-case para URLs e a maioria dos arquivos de configuração, snake_case para módulos Python, camelCase somente quando a linguagem ou o framework exigir — e mantenha a consistência dentro de um mesmo projeto.