Configurare l'ambiente di sviluppo Python in Windows

Preparare l'ambiente Python in pochi minuti in Windows, configurarlo manualmente o automatizzare tutto con winget. Sono necessari gli elementi seguenti:

• Python 3.13 : il runtime Python più recente
• Visual Studio Code : editor di codice leggero e potente
• Estensione Python per Visual Studio Code : aggiunge il supporto del linguaggio Python, il debug, l'linting e altro ancora

Configurazione di WinGet

Il file di configurazione WinGet seguente installa automaticamente tutti gli elementi elencati in precedenza.

Per iniziare:

1. Aprire PowerShell in Terminale Windows ed eseguire il comando seguente:

   winget configure -f https://aka.ms/python-config
   

2. All'avvio della configurazione, una finestra del terminale mostra i passaggi di installazione e le installazioni necessarie. Esaminarli, quindi confermare selezionando [Y] Sì o [N] No per continuare.

3. Vengono installati i carichi di lavoro necessari. Verificare l'installazione eseguendo python --version.

A questo momento si è pronti per lo sviluppo python.

Installazione manuale

1. Installare Python 3.13: installare Python 3 da Microsoft Store. La versione di Microsoft Store configura automaticamente il percorso e fornisce aggiornamenti automatici. Dopo l'installazione, aprire PowerShell ed eseguire python --version per verificare.

2. Installare Visual Studio Code: scaricare e installare Visual Studio Code.

3. Installare l'estensione Python: installare l'estensione Python da VS Code Marketplace.

Introduzione a Python

Domande frequenti

Problemi di installazione di un pacchetto con pip install

Esistono diversi motivi per cui un'installazione avrà esito negativo, in molti casi la soluzione giusta consiste nel contattare lo sviluppatore del pacchetto.

Una causa comune di problemi è il tentativo di installazione in un percorso in cui non si dispone dell’autorizzazione a modificare. Ad esempio, il percorso di installazione predefinito potrebbe richiedere privilegi amministrativi, ma per impostazione predefinita Python non li avrà. La soluzione migliore consiste nel creare un ambiente virtuale e installarlo.

Alcuni pacchetti includono codice nativo che richiede l'installazione di un compilatore C o C++. In generale, gli sviluppatori di pacchetti devono pubblicare versioni precompilata, ma spesso non. Alcuni di questi pacchetti potrebbero funzionare se si installa Build Tools per Visual Studio e si seleziona l'opzione C++, tuttavia nella maggior parte dei casi sarà necessario contattare lo sviluppatore del pacchetto.

Seguire la discussione su StackOverflow

Problemi durante l'installazione di pip con WSL

Quando si installa un pacchetto (ad esempio Flask) con pip nel sottosistema Windows per Linux (WSL o WSL2), ad esempio python3 -m pip install flask, potrebbe verificarsi un errore simile al seguente:

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection
object at 0x7f655471da30>: Failed to establish a new connection: [Errno -3]
Temporary failure in name resolution')': /simple/flask/

A meno che non si esegua un firewall aftermarket, la soluzione probabile consiste nel riinstallare semplicemente pip:

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing

Che cos'è py.exe?

È possibile che nel computer siano installate più versioni di Python perché si usano diversi tipi di progetti Python. Poiché tutti questi usano il python comando, potrebbe non essere ovvio quale versione di Python si usa. Come standard, è consigliabile usare il python3 comando (o python3.7 per selezionare una versione specifica).

L'utilità di avviopy.exe selezionerà automaticamente la versione più recente di Python installata. È anche possibile usare comandi come py -3.7 selezionare una versione specifica o py --list per visualizzare le versioni che è possibile usare. Tuttavia, l'utilità di avvio py.exe funzionerà solo se si usa una versione di Python installata da python.org. Quando si installa Python da Microsoft Store, il py comando non è incluso. Per Linux, macOS, WSL e la versione di Microsoft Store di Python, è consigliabile usare il python3 comando (o python3.7).

Perché l'esecuzione di python.exe apre Microsoft Store?

Per aiutare i nuovi utenti a trovare una buona installazione di Python, è stato aggiunto un collegamento a Windows che consente di passare direttamente alla versione più recente del pacchetto della community pubblicato in Microsoft Store. Questo pacchetto può essere installato facilmente, senza autorizzazioni di amministratore e sostituirà i comandi e python predefiniti python3 con quelli reali.

L'esecuzione del file eseguibile di collegamento rapido con qualsiasi argomento della riga di comando restituirà un codice di errore per indicare che Python non è stato installato. Ciò consente di impedire l'apertura di file batch e script nell'app dello Store quando probabilmente non era previsto.

Se installi Python usando i programmi di installazione da python.org e selezioni l'opzione "aggiungi a PATH", il nuovo comando python avrà la priorità sul collegamento. Si noti che altri programmi di installazione possono aggiungere python a una priorità inferiore rispetto al collegamento predefinito.

È possibile disabilitare i collegamenti senza installare Python aprendo "Gestisci alias di esecuzione dell'app" da Start, trovando le voci Python "App Installer" e impostandole su 'Disattivato'.

Perché i percorsi dei file non funzionano in Python quando vengono copiati?

Le stringhe Python usano "escape" per i caratteri speciali. Ad esempio, per inserire un nuovo carattere di riga in una stringa, digitare \n. Poiché i percorsi di file in Windows usano barre rovesciate, alcune parti potrebbero essere convertite in caratteri speciali.

Per incollare un percorso come stringa in Python, aggiungere il r prefisso . Ciò indica che si tratta di una raw stringa e non verranno usati caratteri di escape ad eccezione di " (potrebbe essere necessario rimuovere l'ultimo backslash dal percorso). Il percorso potrebbe quindi essere simile al seguente: r"C:\Users\MyName\Documents\Document.txt"

Quando si usano i percorsi in Python, è consigliabile usare il modulo pathlib standard. In questo modo sarà possibile convertire la stringa in un oggetto Path avanzato in grado di eseguire modifiche di percorso in modo coerente, indipendentemente dal fatto che usi barre o barre rovesciate, rendendo il codice migliore in diversi sistemi operativi.

Che cos'è PYTHONPATH?

La variabile di ambiente PYTHONPATH viene usata da Python per specificare un elenco di directory da cui è possibile importare i moduli. Durante l'esecuzione, è possibile esaminare la sys.path variabile per vedere quali directory verranno cercate durante l'importazione di un elemento.

Per impostare questa variabile dal prompt dei comandi, usare : set PYTHONPATH=list;of;paths.

Per impostare questa variabile da PowerShell, usare: $env:PYTHONPATH='list;of;paths' subito prima di avviare Python.

L'impostazione di questa variabile a livello globale tramite le impostazioni delle variabili di ambientenon è consigliata, perché può essere usata da qualsiasi versione di Python anziché da quella che si intende usare.

Dove è possibile trovare assistenza per la creazione di pacchetti e la distribuzione?

Docker: l'estensione VSCode consente di creare rapidamente pacchetti e distribuire con Dockerfile e modelli di docker-compose.yml (generare i file Docker appropriati per il progetto).

Il servizio Azure Kubernetes consente di distribuire e gestire applicazioni in contenitori durante il ridimensionamento delle risorse su richiesta.

Cosa succede se è necessario lavorare in computer diversi?

La sincronizzazione delle impostazioni consente di sincronizzare le impostazioni di VS Code tra installazioni diverse usando GitHub. Se si lavora in computer diversi, questo consente di mantenere coerente l'ambiente tra loro.

Cosa accade se si usa PyCharm, Atom, Sublime Text, Emacs o Vim?

Le Keymaps dell'estensione VSCode possono far sentire il tuo ambiente più familiare.

In che modo i tasti di scelta rapida Mac sono mappati ai tasti di scelta rapida di Windows?

Alcuni dei pulsanti di tastiera e dei tasti di scelta rapida di sistema sono leggermente diversi tra un computer Windows e un Macintosh. Questa guida alla transizione da Mac a Windows illustra le nozioni di base.

Dove è possibile ottenere altre informazioni sull'uso di Python in VS Code?

• Modifica di Python in VS Code: altre informazioni su come sfruttare il completamento automatico di VS Code e il supporto di IntelliSense per Python, tra cui come personalizzarne il comportamento... o semplicemente disattivarli.
• Linting Python: Linting è il processo di esecuzione di un programma che analizzerà il codice per individuare potenziali errori. Informazioni sulle diverse forme di supporto di linting fornite da VS Code per Python e su come configurarla.
• Debug di Python: il debug è il processo di identificazione e rimozione di errori da un programma computer. Questo articolo illustra come inizializzare e configurare il debug per Python con VS Code, come impostare e convalidare punti di interruzione, collegare uno script locale, eseguire il debug per diversi tipi di app o in un computer remoto e alcuni problemi di base.
• Unit testing python: illustra in background il significato di unit test, una procedura dettagliata di esempio, l'abilitazione di un framework di test, la creazione e l'esecuzione di test, il debug dei test e le impostazioni di configurazione dei test.