Perché il tuo sito usa il file della cartella al posto della libreria
Il 21 novembre 2026, con Python 3.9.6, un file json.py nella cartella del programma ha risposto al posto della libreria json. Tolto quel file, la stessa richiesta ha usato la libreria standard.
In questa guida (2)
Se nella cartella del programma c’è un file con lo stesso nome di una libreria, Python può eseguire quel file e ignorare la libreria. Il 21 novembre 2026, con Python 3.9.6, un file di prova chiamato json.py ha risposto al posto della libreria json che arriva con Python. Tolto quel file, la stessa richiesta ha usato la libreria standard. La prova è su questo computer, non su un server.
Il file omonimo ha risposto al posto della libreria
Nella cartella della prova c’erano due file. json.py definiva una funzione dumps che restituiva il testo FILE_LOCALE. app.py importava json e stampava il percorso del modulo, il risultato di dumps su un piccolo dizionario, e la prima voce del percorso di ricerca.
Ho lanciato app.py indicando il suo percorso assoluto, con la cartella di lavoro impostata sulla radice del disco, non sulla cartella dei due file. Il percorso stampato finiva con json.py dentro la cartella della prova. dumps ha restituito FILE_LOCALE, non il testo {"a": 1}.
Ho poi rinominato json.py, così nella cartella restava solo app.py, e ho ripetuto lo stesso comando. Il percorso stampato finiva con python3.9/json/__init__.py, il file della libreria che arriva con questa installazione. dumps ha restituito {"a": 1}. La prima voce del percorso di ricerca era ancora la cartella di app.py.
Python guarda prima la cartella del programma
La documentazione di sys.path per Python 3.9 scrive che, all’avvio, la prima voce dell’elenco è la cartella dello script usato per lanciare l’interprete, e che quella cartella viene inserita prima delle voci che arrivano da PYTHONPATH. Se la cartella dello script non c’è, per esempio quando l’interprete è interattivo, la prima voce è una stringa vuota e la ricerca parte dalla cartella di lavoro. La prova di oggi copre solo il primo caso: uno script lanciato con il percorso del file. Non ho provato la modalità interattiva, non ho impostato PYTHONPATH e non ho ripetuto la prova con un’altra versione di Python.
Il nome json è quello della libreria standard e anche quello del file che ho messo accanto al programma. Ho provato solo questo nome. Il controllo utile, sul sito, è stampare il percorso del modulo importato: se punta a un file accanto al programma, è quel file che sta rispondendo.
Un caso diverso, già descritto, è il file del sito che contiene import e non viene eseguito.
L’immagine è codice Rust su uno schermo, 11 febbraio 2026, foto di Slashme, scheda Wikimedia, licenza CC0. Non sono i file Python di questa prova.


