O Que É um Arquivo Oculto? Dotfiles no Unix

Um arquivo oculto no Unix é simplesmente um arquivo cujo nome começa com um ponto, o que por convenção o oculta das listagens de diretório padrão.

Em sistemas do tipo Unix não existe um atributo especial de "oculto"; um arquivo é oculto puramente porque seu nome começa com um ponto. Esses dotfiles guardam configuração, e repositórios de CI estão cheios deles: .gitignore, .github, .env. Conhecer a convenção explica por que um ls às vezes parece não mostrar arquivos e por que globs podem ignorá-los.

O que torna um arquivo oculto

Um ponto inicial no nome do arquivo é toda a história. config é visível; .config é oculto. As ferramentas simplesmente ignoram nomes prefixados com ponto nas listagens padrão como convenção, não como recurso de segurança.

Vendo arquivos ocultos

Executar ls -a mostra todas as entradas, incluindo dotfiles. Sem -a, a listagem as omite, o que pode fazer parecer que arquivos de configuração estão faltando quando na verdade estão apenas ocultos.

Dotfiles comuns em repositórios

• .gitignore lista arquivos que o Git deve ignorar.
• .github/ guarda workflows e config do repositório.
• .env guarda variáveis de ambiente locais.
• .dockerignore exclui arquivos de um contexto de build do Docker.

Globs e dotfiles

Um * simples não corresponde a nomes prefixados com ponto por padrão, então cp * dest/ ignora dotfiles. Isso pega quem copia um projeto e deixa silenciosamente a config para trás.

Arquivos ocultos em CI

A config de CI mora em dotfiles e dot-diretórios. Ao copiar ou fazer cache de arquivos, lembre-se de que * os exclui; você pode precisar de padrões ou opções explícitas para que .github, .env e arquivos similares sejam incluídos ou corretamente ignorados.

Arquivos de config em runners gerenciados

Nos runners da Latchkey, dotfiles se comportam como em qualquer sistema Linux. Quando uma etapa copia o contexto de build, garanta que dot-diretórios como .next ou dotfiles de config sejam tratados explicitamente, para que nada importante seja silenciosamente ignorado.

Principais conclusões

• Um arquivo oculto é apenas aquele cujo nome começa com um ponto.
• ls -a revela dotfiles que as listagens padrão omitem.
• Um glob * ignora dotfiles, o que pode descartar silenciosamente config de CI ao copiar.

Guias relacionados