Come risolvere gli errori di dipendenza in Python 3.15 eliminando uv.lock

Il problema dei lock file con Python 3.15

Da quando è stato rilasciato Python 3.15, alcuni sviluppatori hanno riscontrato errori di dipendenza confusi. Il motivo più comune è la presenza di un file uv.lock che fissa versioni di pacchetti non ancora disponibili per la nuova versione di Python.

Perché le librerie non includono uv.lock

Le librerie Python, per buona pratica, non dovrebbero contenere un file uv.lock. Un lock file imposto da una libreria potrebbe limitare le versioni dei pacchetti per chi la utilizza, creando conflitti di compatibilità.

Quando il lock file crea problemi

Eseguendo comandi come uv run pytest, il tool uv genera automaticamente un uv.lock temporaneo. Questo file è solitamente inserito in .gitignore e non viene versionato. Tuttavia, se il lock fissa una versione di una dipendenza (ad esempio watchfiles==1.1.1) che non dispone ancora di un wheel per Python 3.15, l'esecuzione fallisce con un messaggio simile a:

`` error: Failed to build watchfiles==1.1.1 cause: Call to maturin.build_wheel failed error: the configured Python interpreter version (3.15) is new ``

La regola d'oro: elimina uv.lock

La soluzione più semplice è rimuovere il file uv.lock quando si incontra questo tipo di errore. Senza il lock, uv risolverà nuovamente le dipendenze, scegliendo versioni compatibili con Python 3.15.

Conclusioni

In sintesi, se lavori con Python 3.15 e incontri errori di build legati a dipendenze, la prima azione da compiere è cancellare il file uv.lock. Questo approccio evita blocchi inutili e permette di continuare lo sviluppo senza dover intervenire manualmente su ogni pacchetto.

*Fonte: Simon Willison, 1 novembre 2026*