Condividi tramite


Guida introduttiva: Aprire ed eseguire codice Python in una cartella in Visual Studio

In questa guida introduttiva si seguono i passaggi guidati per eseguire codice Python in Visual Studio 2019 e versioni successive senza dover creare un progetto di Visual Studio. Visual Studio semplifica l'apertura e l'esecuzione di codice Python esistente da una cartella. Le stesse funzionalità e comandi sono disponibili per lo sviluppo di codice Python quando si sceglie di usare un progetto.

Prerequisiti

  • Visual Studio installato con il supporto per i carichi di lavoro Python. Per altre informazioni, vedere Installare il supporto python in Visual Studio.

  • Le istruzioni contenute in questa guida introduttiva si applicano a qualsiasi cartella con codice Python. Per seguire l'esempio descritto in questo articolo, clonare il gregmalcolm/python_koans repository GitHub nel computer usando il comando seguente:

    git clone https://github.com/gregmalcolm/python_koans
    

Visual Studio per Mac non è supportato. Per altre informazioni, vedere What's happening to Visual Studio per Mac? Visual Studio Code in Windows, Mac e Linux funziona bene con Python tramite le estensioni disponibili.

Aprire la cartella del codice locale

Seguire questa procedura per aprire una cartella locale con codice Python esistente in Visual Studio:

  1. Avviare Visual Studio. Nella finestra iniziale selezionare Apri una cartella locale nella colonna Attività iniziali :

    Screenshot che mostra come selezionare l'opzione Apri una cartella locale all'avvio di Visual Studio 2022.

    Screenshot che mostra come selezionare l'opzione Apri una cartella locale all'avvio di Visual Studio.

    Se si usa il codice di esempio del python_koans repository, assicurarsi di selezionare la cartella python3 all'interno della cartella clone.

    Se Visual Studio è già in esecuzione, è possibile selezionare File>Apri>cartella.

  2. Passare alla cartella contenente il codice Python e scegliere Seleziona cartella:

    Screenshot che mostra come selezionare la cartella locale con il codice Python esistente in Visual Studio 2022.

    Screenshot che mostra come selezionare la cartella locale con il codice Python esistente in Visual Studio.

  3. Visual Studio visualizza i file in Esplora soluzioni nella visualizzazione cartelle. È possibile espandere e comprimere una cartella usando la freccia a sinistra del nome della cartella:

    Screenshot che mostra le frecce di espansione e compressione per le cartelle in Esplora soluzioni in Visual Studio 2022.

    Screenshot che mostra le frecce di espansione e compressione per le cartelle in Esplora soluzioni in Visual Studio.

  4. Quando si apre una cartella Python, Visual Studio crea diverse cartelle nascoste per gestire le impostazioni correlate al programma. Per visualizzare queste cartelle (e qualsiasi altro file e cartelle nascosti, ad esempio la cartella .git ), selezionare l'opzione Mostra tutti i file della barra degli strumenti:

    Screenshot che mostra come visualizzare cartelle e file nascosti in Esplora soluzioni in Visual Studio 2022.

    Screenshot che mostra come visualizzare cartelle e file nascosti in Esplora soluzioni in Visual Studio.

Eseguire il programma

Dopo aver aperto il codice Python esistente in Visual Studio, è possibile eseguire il programma. Per eseguire il codice, è necessario identificare il file di avvio (elemento di avvio) o il file di programma primario per Visual Studio per eseguire il programma. In questo esempio il file di avvio è contemplate-koans.py.

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul file contemplate-koans.py e scegliere Imposta come elemento di avvio:

    Screenshot che mostra come impostare il file Python di contemplare koans come elemento di avvio in Esplora soluzioni in Visual Studio 2022.

    Screenshot che mostra come impostare il file Python di contemplare koans come elemento di avvio in Esplora soluzioni in Visual Studio.

    Importante

    Se l'elemento di avvio non si trova nella radice della cartella aperta, è necessario aggiungere anche una riga al file JSON di configurazione di avvio come descritto in Impostare la directory di lavoro.

  2. Eseguire il codice selezionando Avvia debug>senza eseguire debug o usare i tasti di scelta rapida CTRL+F5. È anche possibile selezionare la freccia di riproduzione continua accanto al nome dell'elemento di avvio sulla barra degli strumenti di Visual Studio. Questa opzione esegue il codice nel debugger di Visual Studio.

    Per tutti questi metodi di avvio, Visual Studio rileva che l'elemento di avvio è un file Python ed esegue automaticamente il codice nell'ambiente Python predefinito. L'ambiente corrente viene visualizzato a destra del nome dell'elemento di avvio sulla barra degli strumenti. Nell'esempio seguente l'ambiente corrente è Python 3.11 (64 bit):

    Screenshot che mostra come avviare il programma con il debug usando la freccia di riproduzione continua sulla barra degli strumenti di Visual Studio 2022.

    Per tutti questi metodi di avvio, Visual Studio rileva che l'elemento di avvio è un file Python ed esegue automaticamente il codice nell'ambiente Python predefinito. L'ambiente corrente viene visualizzato a destra del nome dell'elemento di avvio sulla barra degli strumenti. Nell'esempio seguente l'ambiente corrente è Python 3.6 (32 bit):

    Screenshot che mostra come avviare il programma con il debug usando la freccia di riproduzione continua in Visual Studio.

    Se l'ambiente Python corrente non è visibile sulla barra degli strumenti, selezionare Visualizza>altri ambienti Python di Windows.>

  3. Quando il programma viene eseguito, Visual Studio apre una finestra di comando per visualizzare l'output del programma:

    Screenshot della finestra di output visualizzata da Visual Studio 2022 per l'output del programma dal codice Python in esecuzione.

    Screenshot della finestra di output visualizzata da Visual Studio per l'output del programma dal codice Python in esecuzione.

    Nota

    Se si esegue il python-koans programma con il debug, è necessario modificare i valori nel codice per completare l'esecuzione del programma.

  4. È possibile eseguire il codice in un ambiente Python diverso:

    1. Espandere l'elenco a discesa Ambiente Python corrente nella barra degli strumenti di Visual Studio e selezionare l'ambiente desiderato.

    2. Riavviare il programma.

  5. Quando si è pronti per chiudere la cartella del codice in Visual Studio, selezionare Chiudi cartella file>.

Impostare la directory di lavoro

Per impostazione predefinita, Visual Studio esegue un progetto Python aperto come cartella nella radice della stessa cartella. Tuttavia, il codice nel progetto potrebbe prevedere l'esecuzione di Python in una sottocartella. Quando il codice prevede di trovare file in posizioni diverse rispetto alla configurazione predefinita riconosciuta da Visual Studio, è possibile riscontrare errori quando si tenta di eseguire il codice.

Si supponga di aprire la cartella radice del python_koans repository e di visualizzare una sottocartella denominata python3 che contiene un file Python denominato contemplate-koans.py. Si decide di impostare il file python3/contemplate-koans.py come file di avvio. Quando si esegue il codice, viene visualizzato un errore che indica che non è possibile trovare un file denominato koans.txt . L'errore si verifica perché il file contemplate-koans.py prevede l'esecuzione di Python nella cartella python3 anziché nella radice del repository.

In questi casi, è anche necessario aggiungere una riga al file JSON di configurazione di avvio per specificare la directory di lavoro:

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di avvio di Python (.py) e scegliere Aggiungi configurazione di debug:

    Screenshot che mostra come selezionare l'opzione Aggiungi configurazione di debug per un file selezionato in Esplora soluzioni in Visual Studio 2022.

  2. Nella finestra di dialogo Seleziona debugger selezionare l'opzione Predefinita nell'elenco e quindi scegliere Seleziona:

    Screenshot che mostra come selezionare il debugger predefinito nella finestra di dialogo Seleziona un debugger in Visual Studio 2022.

    Nota

    Se l'opzione Predefinita non è visualizzata, assicurarsi di scegliere un file di .py Python quando si seleziona il comando Aggiungi configurazione di debug. Visual Studio usa il tipo di file per determinare quali opzioni del debugger visualizzare.

  3. Visual Studio apre un file denominato launch.vs.json, che si trova nella cartella nascosta .vs. Questo file descrive il contesto di debug per il progetto. Per specificare una directory di lavoro, aggiungere un valore per la "workingDirectory" proprietà . python-koans Ad esempio, è possibile aggiungere la proprietà e il valore , "workingDirectory": "python3":

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "contemplate_koans.py",
          "projectTarget": "",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. Salvare le modifiche apportate al file launch.vs.json .

  5. Eseguire di nuovo il programma. L'esecuzione del codice dovrebbe ora essere eseguita nella cartella specificata.

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di avvio di Python (.py) e scegliere Debug e avvio Impostazioni:

    Screenshot che mostra come selezionare l'opzione Debug e Avvia Impostazioni per un file selezionato in Esplora soluzioni in Visual Studio.

  2. Nella finestra di dialogo Seleziona debugger selezionare l'opzione Predefinita nell'elenco e quindi scegliere Seleziona:

    Screenshot che mostra come selezionare il debugger predefinito nella finestra di dialogo Seleziona debugger in Visual Studio.

    Nota

    Se l'opzione Predefinita non è visualizzata, assicurarsi di scegliere un file di .py Python quando si seleziona il comando Debug e Avvia Impostazioni. Visual Studio usa il tipo di file per determinare quali opzioni del debugger visualizzare.

  3. Visual Studio apre un file denominato launch.vs.json, che si trova nella cartella nascosta .vs. Questo file descrive il contesto di debug per il progetto. Per specificare una directory di lavoro, aggiungere un valore per la "workingDirectory" proprietà . python-koans Ad esempio, è possibile aggiungere la proprietà e il valore , "workingDirectory": "python3":

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "contemplate_koans.py",
          "projectTarget": "",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. Salvare le modifiche apportate al file launch.vs.json .

  5. Eseguire di nuovo il programma. L'esecuzione del codice dovrebbe ora essere eseguita nella cartella specificata.