Innlegg
3 grunner til hvorfor kodeoversikter er viktige
28. januar 2015 • 3 min lesing
En god kodeoversikt vil utfordre dine antagelser og gi deg konstruktiv tilbakemelding. For meg er kodeoversikter en vesentlig del av veksten som programvareingeniør.
Å skrive kode er en intim prosess. Programvareingeniører bruker år på å lære håndverket innen programvareutvikling, og når noe kritisk blir sagt om vår skapelse, er det vanskelig ikke å ta det personlig. Jeg finner meg selv, til tider, blir defensiv når jeg hører kritikk. Jeg vet at anmelderen mener godt, men dette er ikke alltid trøstende. Hvis det ikke var for ærlig tilbakemelding fra noen eksepsjonelle programvareingeniører, ville jeg ikke vært halvparten av programvareingeniøren jeg er i dag.
Fordeler med kodeoversikter
1. Finne feil
Noen ganger er det det enkle faktum å lese koden som gjør at du finner en feil. Noen ganger er det den andre utvikleren som oppdager feilen. Uansett, bare det å gå gjennom koden er nok til å avdekke potensielle problemer.
Jeg tenker på mine feil som slipestenen til sverdet mitt. For å sitere Michael Jordan:
I’ve missed more than 9000 shots in my career. I’ve lost almost 300 games. 26 times, I’ve been trusted to take the game winning shot and missed. I’ve failed over and over and over again in my life. And that is why I succeed.
2. Kunnskapsoverføring
Å dele arbeidet ditt med andre er ydmykende. På mange måter er du koden. Jeg vet at jeg føler meg sårbar når jeg deler koden min.
Dette er en flott mulighet til å lære fra og å lære andre ingeniører. Ved å dele koden din tar du anmelderne på en reise, en reise inn i koden og aspekter om deg. Mye kan læres om deg av hvordan du skriver kode.
På slutten av kodeoversikten bør anmelderne ha en god forståelse av hvordan koden fungerer, begrunnelsen bak den, og vil ha lært litt om deg.
3. Forbedring av kodehelsen
Som jeg nevnte, jo flere ganger du leser koden, jo bedre blir koden. Jo flere anmeldere, jo større sjanse for at en av dem vil foreslå en forbedring. Noen kan tenke at ferdighetsnivå betyr noe, det gjør det ikke. Mindre erfarne programvareingeniører har ikke den dype teknologiske kunnskapen som erfarne programvareingeniører, men de trenger heller ikke å vade gjennom all den mentale tekniske bagasjen for å se muligheter for forbedring.
Kodeoversikter gir oss fordelen av å evaluere koden vår. Det vil alltid være noe å endre for å gjøre det bare litt bedre.
Koding er på denne måten mye som skriving. For at et godt stykke skal komme i fokus, må koden hvile og bli lest på nytt. Jo flere ganger du gjentar denne prosessen, jo bedre blir koden.
Avslutningsvis
Noen selskaper gjør ikke offisielt kodeoversikter, det er greit. Søk opp andre ingeniører. De fleste programvareingeniører vil være glade for å bruke 10 til 15 minutter på å se over koden din.
Forfatter: Chuck Conway er en AI-ingeniør med nesten 30 års erfaring innen programvareutvikling. Han bygger praktiske AI-systemer—innholdspipelines, infrastrukturagenter og verktøy som løser virkelige problemer—og deler det han lærer underveis. Koble til ham på sosiale medier: X (@chuckconway) eller besøk ham på YouTube og på SubStack.