Convenções de nomes para variáveis de ambiente: Melhores práticas
4 min de leitura
Variáveis de ambiente usam SCREAMING_SNAKE_CASE universalmente: DATABASE_URL, NODE_ENV, API_SECRET_KEY.
Regras de nomenclatura
- TUDO_EM_MAIÚSCULAS com underscores — sem exceções
- Usar prefixos significativos:
DB_HOST,DB_PORT,DB_NAME - Prefixo específico do app para evitar conflitos:
MYAPP_API_KEY - Variáveis booleanas:
ENABLE_CACHE=true,DEBUG=false
Padrões comuns
| Categoria | Exemplos |
|---|---|
| Banco de dados | DATABASE_URL, DB_HOST, DB_PASSWORD |
| API | API_KEY, API_BASE_URL, API_TIMEOUT |
| Servidor | PORT, HOST, NODE_ENV |
| Auth | JWT_SECRET, OAUTH_CLIENT_ID |
| Feature flags | ENABLE_DARK_MODE, BETA_FEATURES |
Converter
Use o conversor CONSTANT_CASE ou o hub de conversão de case.