Stack

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.

Marco Conte 2 min di lettura

Perché il tuo sito usa il file della cartella al posto della libreria
In questa guida (2)
  1. 1Il file omonimo ha risposto al posto della libreria
  2. 2Python guarda prima la cartella del programma

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.

Potrebbe interessarti anche...

Hai bisogno di scegliere una webagency per il tuo progetto?

Abbiamo la soluzione giusta

Parliamone
  • Consulenza specializzata
  • Soluzioni su misura
  • Risultati concreti

Tecnologialiberaper tutti

Hai bisogno d'aiuto?

Parla con noi. Il nostro supporto è attivo tutti i giorni dalle 9 alle 18

+390835239514 Chiamaci

Crea il tuo eCommerce

Creiamo eCommerce su misura senza farti spendere un patrimonio

info@roxxoitalia.com Scopri il nostro CMS

Crea il tuo sito web

Siti web già pronti per andare online. Vuoi saperne di più? Contattaci

info@roxxoitalia.com Scrivici