Scegliere un nome chiaro ed espressivo per le variabili è uno dei passi più importanti per scrivere codice leggibile, ordinato e facile da mantenere (il cosiddetto Clean Code).
L'identificatore di una variabile deve comunicare immediatamente quale dato contiene e qual è il suo ruolo all'interno del programma. Per evitare errori di sintassi e confusione, la programmazione stabilisce alcune regole fondamentali rigide e diverse convenzioni di stile condivise a livello internazionale.
Regole Rigide
Vincoli sintattici obbligatori imposti dai linguaggi per evitare errori di compilazione.
Significatività
Il nome deve spiegare il contenuto senza bisogno di commenti (es. prezzoTotale).
Maiuscole/Minuscole
Nella maggior parte dei linguaggi, eta e Eta sono due variabili distinte.
Convenzioni
Standard grafici (camelCase, snake_case) usati nei team di sviluppo.
Tutti i linguaggi di programmazione applicano quattro regole ferree per validare il nome di una variabile:
1. Caratteri Validi
Sì a lettere (A-Z, a-z), numeri (0-9) e il trattino basso (_). No ad accenti o caratteri speciali (@, !, ?, %).
2. No Cifre all'Inizio
Il nome non può mai iniziare con un numero (es. 1numero è ERRORE, usa numero1).
3. Niente Spazi
I nomi delle variabili non possono contenere spazi vuoti (es. somma totale genera errore).
4. Parole Riservate
Non si possono usare le parole chiave del linguaggio (es. if, while, for, int, class).
Poiché le variabili non possono contenere spazi, si usano diverse convenzioni di notazione per unire più parole rimanendo leggibili:
camelCase
Prima parola tutta in minuscolo, le parole successive con la prima lettera maiuscola.
nomeUtenteprezzoTotaleInEuro
snake_case
Tutto in minuscolo con le parole separate da un trattino basso (underscore _).
nome_utenteprezzo_totale_in_euro
PascalCase
Tutte le parole hanno la prima lettera maiuscola (usato spesso per le Classi).
NomeUtentePrezzoTotaleInEuro
UPPER_SNAKE
Tutto in MAIUSCOLO separato da underscore. Riservato solitamente alle Costanti.
PI_GRECOVALORE_MASSIMO
Sintesi visiva delle regole di nomenclatura e confronto delle principali convenzioni di codice:
Mappa Concettuale: Nomi e Nomenclatura delle Variabili
temperaturaMedia è nettamente migliore di t o x).
SISTEMA DI NOMENCLATURA │ ├── 1. REGOLE SINTATTICHE IMPERATIVE (Se violate, il codice non funziona) │ ├── Consentiti ─────────────> Lettere (a-z, A-Z), Cifre (0-9) e Underscore (_) │ ├── Inizio Obbligatorio ────> Solo Lettera o Underscore (MAI numeri!) │ ├── Divieti ────────────────> No spazi, no trattini (-), no accenti, no simboli (@, !, %) │ └── Parole Riservate ───────> No parole chiave del linguaggio (if, else, int, for) │ ├── 2. CONVENZIONI DI SCRITTURA (STILI) (Per la leggibilità del team) │ ├── camelCase ──────────────> primaParolaMinuscolaAggiunteMaiuscole (es. mediaVoti) │ ├── snake_case ─────────────> tutto_in_minuscolo_con_underscore (es. media_voti) │ ├── PascalCase ─────────────> TutteLeParoleConInizialeMaiuscola (es. MediaVoti - per Classi) │ └── UPPER_SNAKE_CASE ──────> TUTTO_MAIUSCOLO_CON_UNDERSCORE (es. MAX_LIMIT - per Costanti) │ └── 3. BUONE PRATICHE (CLEAN CODE) (Consigli pratici) ├── Auto-esplicativo ──────> Preferisci $scontoStudente rispetto a $s ├── Consistenza ───────────> Mantieni lo stesso stile in tutto il progetto └── Lingua Inglese ────────> Consigliata nella programmazione professionale (es. $totalPrice)
Glossario dei Termini (IT / EN)
| Termine Italiano | Termine Inglese | Definizione Sintetica |
|---|---|---|
| Identificatore | Identifier | Il nome assegnato dal programmatore a elementi come variabili, funzioni o classi. |
| Notazione a Cammello | camelCase | Stile in cui le parole unite iniziano con la maiuscola eccetto la prima (es. votoFinale). |
| Notazione a Serpente | snake_case | Stile con parole minuscole separate da tratti bassi (es. voto_finale). |
| Notazione Pascal | PascalCase / UpperCamelCase | Stile in cui ogni singola parola inizia con la maiuscola (es. VotoFinale). |
| Sensibilità al Maiuscolo | Case Sensitivity | Proprietà per cui il linguaggio distingue tra lettere maiuscole e minuscole. |
| Parola Riservata | Reserved Word / Keyword | Parola con un significato speciale per il compilatore che non può essere usata come nome. |
| Codice Pulito | Clean Code | Filosofia di programmazione basata sulla scrittura di codice ordinato, leggibile e ben strutturato. |