Quando você tem que dar um nome pra alguma coisa e simplesmente não sabe o que escolher
É uma situação que acontece todo dia no meu trabalho. Você tá olhando pra um arquivo, uma função, uma classe, e na hora de escrever o código ou documentar, sua mão trava. Qual nome desse? Parece besteira, mas é um dos problemas mais chatos da programação e também do uso diário de qualquer ferramenta que envolva organização de arquivos. Eu trabalho com sistemas de gestão de estoque há uns cinco anos. Uma vez precisei renomear mais de trezentos arquivos que tinham sido criados por um script automatizado onde o desenvolvedor não quis dar nome próprio pra nada. Chamava tudo de "arquivo (1)", "arquivo (2)", "dados_001", "dados_002". Foi um sofrimento danado achar o que era cada um só pela data de modificação.
Por que a gente travam nisso
O cérebro humano tem uma preguiça cognitiva real quando precisa extrair uma essência abstrata e transformá-la em duas ou três palavras. A gente pensa rápido demais, o nome sai genérico, e depois passa dois dias procurando por algo que você mesmo criou. No exemplo acima, eu poderia ter usado uma convenção simples. Um prefixo com o tipo de documento, um sufixo com a data no formato YYYYMMDD, e um identificador numérico. Ficaria assim: "estoque_20231015_001.csv". Em menos de dez segundos você sabe o que é o arquivo, quando foi criado e qual a sequência.
Eu já vi gente usar até nomes mais criativos como "documento_final_v2_revisado_realmente_final.xlsx". Isso não resolve o problema, só aumenta o tamanho desnecessariamente e continua sem dizer nada sobre o conteúdo real.
A regra prática que eu sigo
Antes de criar qualquer nome, eu me faço três perguntas: o que isso é? Para que serve? Quem mais vai usar? Se a resposta for alguma coisa tipo "é um arquivo de exportação de vendas do mês de outubro", já tenho meio caminho andado. "Exportacao_vendas_202310" é um nome que funciona. Não precisa serPoético, não precisa ser engraçado. Precisa ser claro pra quem vier depois.
Eu gosto de escrever os nomes em minúsculas, sem espaços, usando underline pra separar as partes. Evito caracteres especiais porque às vezes o sistema não deixa e você perde tempo briga com encoding que não veio pedir.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Erros comuns que eu vejo todo dia
Nomes muito curtos e vagos. "teste", "temp", "dados". Isso é informação zero. Quando você voltar em seis meses, vai saber exatamente nada sobre o que aquele arquivo guarda. Named em inglês ou português misturado sem critério. Se o time todo fala português, escreve em português. Se é código, o padrão é inglês. Mas não faz um trocadilho sem graça em cada arquivo, senão vira uma bagunça só pra você mesmo.
Esquecer de padronizar com o resto do projeto. Se todo mundo usa hífen, não crie uma exceção com seu arquivo usando underline. A consistência interna vale mais do que qualquer preferência pessoal sua. Na minha experiência, o problema mais frequente é subestimar quanto tempo um nome ruim vai custar depois. Você gasta trinta segundos criando o nome certo agora e economiza meia hora semana que vem quando precisa rastrear um bug ou refazer uma importação.
Eu já recomendei essa abordagem pra vários colegas e a taxa de satisfação é alta. Nomes claros reduzem a carga cognitiva do time todo, não só de quem escreveu originally. É um daqueles detalhes pequenos que fazem diferença gigante no dia a dia.
Quando não existe um nome bom
Às vezes você realmente não consegue pensar em nada melhor do que algo vago. Nesse caso, eu prefiro adicionar um comentário no início do arquivo ou criar um README explicando o contexto. Pelo menos quem chegar depois vai ter uma pista, mesmo que o nome continue mediano. Também vale a pena consultar o histórico do projeto. Muitas vezes você vê que um padrão já existe pra coisas parecidas e pode reaproveitar a mesma estrutura. Copiar convenção alheia é melhor do que inventar uma nova que vai conflitar com tudo mais.
Se o arquivo ou item é mesmo temporário, coloca "tmp_" na frente e define uma data de exclusão no nome. "tmp_exportacao_20231015_expira_20231022". Assim você não deixa lixo pra trás e ainda consegue identificar quando deve ser removido.
