---
title: "Codice legacy che nessuno vuole più toccare | QMates"
source: https://qmates.tech/it/servizi/trasformazione/refactoring-codice-legacy/codice-legacy-intoccabile
description: "Il codice legacy che il team evita nasconde dipendenze, test mancanti e conoscenza in poche teste. A piccoli passi lo si rende di nuovo modificabile."
updated: 2026-11-21
---

Codice legacy

# C’è codice che nessuno vuole più toccare

Più un modulo di codice legacy viene evitato, meno persone lo conoscono, e meno lo si conosce più ogni modifica sembra rischiosa: così il codice nuovo cresce accanto a quello vecchio, che resta com’è. Lo sostengono dipendenze invisibili, test che mancano e un debito che cede sempre il passo alle funzionalità, per cui la pulizia di quel solo modulo dura fino alla modifica successiva.

## Vi riconoscete?

-   Prima di toccare certi moduli si chiede a chi li ha scritti, e se quella persona è in ferie si aspetta.
-   Una modifica piccola rompe una funzionalità che sta in tutt’altra parte del sistema.
-   Il team aggiunge codice nuovo accanto a quello vecchio pur di non modificarlo.
-   Su quelle parti mancano i test automatici, così ogni modifica si verifica a mano, a lungo e senza certezze.
-   Prima o poi qualcuno, nel team, propone di riscrivere tutto.

## Che cosa rende intoccabile quel codice?

La catena comincia spesso dai test che mancano: senza una rete, sistemare quel codice è rischioso e perde contro le funzionalità. Il debito che resta intreccia i moduli fra loro, e alla fine soltanto chi li ha scritto sa dove mettere le mani.

1.  ### Moduli legati da fili invisibili

    Le dipendenze più costose non compaiono negli import: passano per il database condiviso, per una cache, per una convenzione che tutti rispettano senza averla mai scritta. Chi modifica un modulo non può sapere cosa trascina con sé, finché i confini fra le parti non tornano a seguire quelli del dominio.

    Alimenta

    -   

    [

    Ce ne occupiamo con

    Domain-Driven Design ed EventStorming](https://qmates.tech/it/servizi/trasformazione/domain-driven-design-event-storming)

2.  ### Sotto il codice vecchio manca la rete dei test

    Michael Feathers chiama legacy il codice senza test: senza test, l’unico modo per sapere se una modifica ha rotto qualcosa è aspettare che succeda. I test di caratterizzazione fissano il comportamento di oggi, errori compresi, e permettono di lavorare anche su codice non ancora capito fino in fondo.

    Alimenta

    -   

    [

    Ce ne occupiamo con

    Refactoring del codice legacy](https://qmates.tech/it/servizi/trasformazione/refactoring-codice-legacy)

3.  ### Lo conoscono davvero in pochi

    Una parte del sistema che si capisce solo leggendola per intero finisce per conoscerla chi l’ha scritta, mentre gli altri imparano a girarle intorno. Ogni modifica passa da quelle persone, che diventano il collo di bottiglia del team e il suo rischio maggiore il giorno in cui se ne vanno.

    [

    Ce ne occupiamo con

    Innesto nell'organizzazione](https://qmates.tech/it/servizi/trasformazione/innesto)

4.  ### Il debito perde sempre contro le funzionalità

    Finché non si sa quanto costa lasciare quel codice com’è, sistemarlo resta una richiesta del team contro le richieste del business, e perde. Intanto ogni funzionalità costruita sopra lo rende un po’ più difficile da cambiare.

    Alimenta

    -   

    [

    Ce ne occupiamo con

    Assessment del debito tecnico](https://qmates.tech/it/servizi/trasformazione/assessment-debito-tecnico)

- [Il servizio che se ne occupa](https://qmates.tech/it/servizi/trasformazione/refactoring-codice-legacy)
- [Non sapete quale causa pesa di più?](https://qmates.tech/it/servizi/trasformazione/assessment-debito-tecnico)

## Cosa cambia quando il codice torna modificabile

Il codice vecchio torna a essere codice come gli altri: lo si cambia protetti dai test, una modifica tocca il punto che deve toccare e chiunque nel team può prenderla in carico. Il refactoring entra nel lavoro di ogni giorno e segue la roadmap, a piccoli passi, senza un progetto a parte.

Quando chi ha scritto un modulo è in ferie, la modifica che lo riguarda parte lo stesso, e una funzionalità che passa da quel codice si stima come le altre. Anche la proposta di riscrivere tutto, se qualcuno la ripropone, si discute partendo dai test.
