Sebbene diverse risposte utili siano state pubblicate qui per un po ', credo che ci sia spazio per un'altra. Il mio suggerimento è, come altri hanno detto, di fare revisioni del codice. Ma vale la pena menzionarlo di nuovo perché il termine "revisione del codice" è così vago ... quasi altrettanto vago di "codice pulito" :-). Ho dedicato molto tempo e impegno a lavorare su questo obiettivo inafferrabile. E in particolare negli ultimi due anni, alimentato da colleghi che condividevano la mia passione, ho distillato le mie nozioni, fondendomi con idee chiave di importanti sviluppatori, in una serie intitolata Zen of Code Reviews .
I miei articoli sono unici, per quanto ne so, in quanto copro entrambi lati del corridoio: eseguendo una revisione del codice come autore e facendo una revisione del codice come recensore . Anche se correlati, le abilità per ciascuno sono alquanto diverse. Ed essere in grado di fare entrambe le cose porterà a una migliore qualità del codice. La revisione del codice è importante tanto quanto scrivere codice. Realmente. Promuove il trasferimento delle conoscenze, incoraggia la coerenza e la comunicazione del team, aiuta a migliorare il tuo mestiere e, ultimo ma non meno importante, riduce il software buggy in modo molto conveniente - dal più vicino possibile al lancio .
I primi due forniscono suggerimenti e tecniche per preparare una revisione del codice. In poche parole:
- Come autore, hai una conoscenza approfondita del motivo per cui ogni riga modificata è presente nella revisione del codice. Molti sono ovvi per un revisore esperto, ma molti non lo sono. Raccogli i punti annotando la revisione del codice prima di inviarlo ai revisori.
- Ancora prima, considera attentamente cosa comprende la revisione del codice: assicurati di includere tutte le modifiche pertinenti per un problema e prova a non includere più di un problema.
- Assicurati di eseguire un controllo del controllo del codice sorgente (per risincronizzare il codice con il principale) prima di inviarlo.
- Controlla il tuo codice prima di inviarlo, riga per riga!
Part 1: Pre-Review Comments: Empower your colleagues to give you
better feedback on your code review
Part 2: Best Practices:
Guidelines for preparing a code review
E gli altri due articoli forniscono consigli pratici su come essere un revisore migliore:
- Leggi prima Jira / issue / ticket / requirement (qualunque cosa tu lo chiami)
- Verifica che i test unitari coprano i requisiti.
- Rivedi i test unitari per la classe di equivalenza e la completezza del valore al contorno.
- Verifica che ogni test dell'unità funzioni quanto basta, non testando più cose.
- Rivedi il codice per l'adesione ai principi SOLID.
- Fai attenzione a reinventare ruote, codice complicato e codice complicato.
- Evita la magia (stringhe magiche, intarsi magici e, sì, anche i booleani magici).
- Cattura l'effetto farfalla - ci sono increspature che sono state perse (ad esempio incoerenze nella denominazione).
Part 3: The Reviewer's Tale: Guidelines for performing a code review
Part 4: Review As If You Own the Code