Escreva O Nome Das Imagens

Como dar nomes corretos às imagens do seu projeto

Escrever o nome das imagens parece uma tarefa simples no começo, mas na prática é onde a maioria dos times perde horas sem perceber. Eu fui atrás de entender isso porque estava recebendo arquivos batidos de formas completamente aleatórias — algumas com underscores, outras com hífens, espaços, datas no formato errado e um monte de caracteres em caixa alta que só serviam para confundir quem precisava encontrar algo depois.

O problema real não é criar um nome. É criar um nome que qualquer pessoa ou ferramenta consiga interpretar sem pensar. A maioria dos desenvolvedores e designers esquece que o nome do arquivo carrega informação útil: data do projeto, versão, tipo de asset, permissão de uso. Quando você junta isso direito, economiza tempo de busca e evita conflitos de sobreposição. Aqui está o método que funciona no dia a dia, sem complicação: 1. Comece pelo escopo — antes de bater qualquer nome, defina o que aquela imagem representa. É uma foto? Um ícone? Um gráfico? Isso já define o primeiro segmento do nome. Use termos curtos e universais: foto, icon, graf, print, banner. Se o projeto for técnico, abreviações como "cap" para captura de tela ou "mock" para protótipo também funcionam, desde que toda a equipe saiba o que significam.

2. Defina a sequência padrão — a estrutura mais segura que eu uso é: [tipo]_[projeto]_[descricao]_[versao].[extensao]. Um exemplo real: "banner_homepage_v2.png" ou "icon_dashboard_alt.svg". A ordem dos segmentos importa. Coloque sempre o tipo primeiro, porque é isso que filtra os resultados quando você vai procurar por extensão ou categoria depois. 3. Use hífen ou underscore, não os dois — isso parece bobo, mas eu vi gente usando hífen em um arquivo e underscore no outro para o mesmo projeto. Ferramentas de build e CMS às vezes tratam os dois caracteres como símbolos diferentes. Escolha um e seja consistente. Eu prefiro o hífen porque funciona melhor em URLs e em nomes de pasta. 4. Nunca use espaços — isso é fundamental. Espaços em nomes de arquivo viram problemas de upload, quebra de link e erro de compilação. Se precisar separar palavras, use hífen ou underscore. Sempre.

5. Versionamento simples — não invente sistemas complexos de numeração. v1, v2, v3 funcionam perfeitamente. Se quiser registrar a data, use ISO 8601: 2025-07-14. Formato YYYY-MM-DD evita confusão entre dia e mês, algo que eu levou três meses para perceber porque um colega europeu e um colega brasileiro estavam trabalhando no mesmo repositório. 6. Extensão correta — PNG para imagens com transparência, JPG para fotografias, SVG para ícones e vetores, WebP quando o performance importar. Não salve tudo como PNG só porque é mais fácil. Arquivos pesados demais quebram o carregamento da página e aumentam o tempo de build.

o caso que me fez mudar tudo

Eu estava lidando com um projeto de e-commerce que tinha mais de oito mil imagens. O nome padrão era algo do tipo "foto_produto_final_modificada.jpg". Quando precisei encontrar uma imagem específica, não dava para filtrar por data ou variante. Troquei a nomenclatura para: "ecommerce_produto_[sku]_[cor]_[angulo].jpg" — SKU do produto, cor e ângulo da foto. Isso reduziu o tempo de localização de cerca de vinte minutos para uns quinze segundos em média, dependendo da busca. Regra prática: nomes muito longos também são problema. Alguns sistemas operacionais e servidores têm limite de 255 caracteres para nomes de arquivo. Nomes com mais de cinquenta caracteres já começam a causar problema em CI/CD pipelines antigos. Corte o que não for essencial. Outra coisa importante: evite palavras-chave em excesso. Ninguém precisa de "banner_homepage_principal_destaque_oferta_verao_2025.jpg". Coloque o suficiente para identificar. O resto vai no metadata ou na descrição do CMS.

Se o projeto envolver múltiplas versões de um mesmo ativo, não renomeie o original. Crie cópias com sufixo de versão. Assim você nunca perde a referência inicial e ainda mantém o histórico de alterações organizado. Existem ferramentas de batch rename que ajudam, mas eu recomendo ter um script simples ou um padrão escrito em algum lugar acessível. Quando a equipe cresce, cada pessoa começa a usar seu próprio jeito e o sistema de nomes desmorona em duas semanas.