Raccomando le Guide di stile di Google per il linguaggio di programmazione che stai utilizzando. Mi attengo a queste regole e di solito portano a un codice dall'aspetto pulito. Ci sono qualcosa che mi aggiungo (come 2 righe vuote tra le funzioni) ma nel complesso mi piacciono molto le Guide di stile di Google .
Aggiornamento:
Le diverse guide di stile variano un po 'per lingua, poiché vengono assemblate da diversi ingegneri che dedicano tutto il loro tempo a lavorare in quel linguaggio, quindi ciò che hanno scritto è ciò che credono porta a un codice dall'aspetto pulito. Sembra che, in generale, la regola empirica sia di utilizzare solo righe vuote per distinguere i gruppi di codici. Più linee vuote consecutivi non vengono quasi mai incoraggiate. Ecco alcuni estratti da queste guide:
Java
Viene visualizzata una singola riga vuota:
-
Tra membri consecutivi (o inizializzatori) di una classe: campi, costruttori,
metodi, classi annidate, inizializzatori statici, inizializzatori di istanze.
-
Eccezione: una linea vuota tra due consecutivi
i campi (non avendo altro codice tra loro) è facoltativo. Tali righe vuote vengono utilizzate secondo necessità
crea raggruppamenti logici di campi.
- All'interno dei corpi dei metodi, come necessario per creare raggruppamenti logici di istruzioni.
-
Facoltativamente prima del primo membro o dopo l'ultimo membro della classe (nessuno dei due
incoraggiato o scoraggiato).
- Come richiesto da altre sezioni di questo documento (come la Sezione 3.3,
Importa istruzioni).
Più righe vuote consecutivi sono consentite, ma mai richieste (o incoraggiate).
Python
Due righe vuote tra definizioni di primo livello, siano esse definizioni di funzioni o di classi. Una riga vuota tra le definizioni del metodo e tra la riga di classe e il primo metodo. Usa singole righe vuote come ritieni opportuno all'interno di funzioni o metodi.
C ++
Riduci al minimo l'utilizzo degli spazi bianchi verticali.
Questo è più un principio che una regola: non usare righe vuote quando non è necessario. In particolare, non mettere più di una o due righe vuote tra le funzioni, resistere alle funzioni iniziali con una riga vuota, non terminare le funzioni con una riga vuota e discriminare con l'uso di righe vuote all'interno delle funzioni.
Il principio di base è: più codice si adatta a uno schermo, più facile è seguire e comprendere il flusso di controllo del programma. Naturalmente, la leggibilità può risentire del fatto che il codice è troppo denso e troppo diffuso, quindi usa il tuo giudizio. Ma in generale, minimizza l'uso degli spazi bianchi verticali.
Alcune regole pratiche per aiutare quando le righe vuote possono essere utili:
- Le righe vuote all'inizio o alla fine di una funzione aiutano molto raramente la leggibilità.
- Le righe vuote all'interno di una catena di blocchi if-else possono aiutare a migliorare la leggibilità
Objective-C
Le righe vuote prima e dopo @interface, @implementation e @end sono opzionali. Se @interface dichiara le variabili di istanza, una riga vuota dovrebbe venire dopo la parentesi di chiusura (}).
A meno che un'interfaccia o un'implementazione siano molto brevi, come quando si dichiarano una manciata di metodi privati o una classe bridge, l'aggiunta di righe vuote di solito aiuta la leggibilità.
Inserisco qui solo le informazioni sugli spazi bianchi verticali, ma alcune guide hanno anche informazioni sugli spazi bianchi orizzontali e molte più informazioni di formattazione (commenti, blocchi, rientri, ecc ...)
E il progetto è open source quindi se hai qualche suggerimento potresti mandare un'email a uno dei proprietari del progetto.