Compartir a través de


Inicio rápido: Apertura y ejecución de código de Python en Visual Studio

En este inicio rápido, seguirá los pasos guiados para ejecutar código de Python en Visual Studio 2019 y versiones posteriores sin tener que crear un proyecto de Visual Studio. Visual Studio facilita la apertura y ejecución del código de Python existente desde una carpeta. Las mismas características y comandos están disponibles para el desarrollo de código de Python y cuando decide trabajar con un proyecto.

Requisitos previos

  • Visual Studio instalado con compatibilidad con cargas de trabajo de Python. Para obtener más información, consulte Instalación de la compatibilidad con Python en Visual Studio.

  • Las instrucciones de este inicio rápido se aplican a cualquier carpeta con código de Python. Para seguir el ejemplo descrito en este artículo, clone el repositorio de GitHub gregmalcolm/python_koans en su ordenador mediante el comando siguiente:

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

Visual Studio para Mac no se admite. Para obtener más información, consulte ¿Qué sucede con Visual Studio para Mac? Visual Studio Code en Windows, Mac y Linux funciona bien con Python a través de extensiones disponibles.

Apertura de la carpeta de código local

Siga estos pasos para abrir una carpeta local con código de Python existente en Visual Studio:

  1. Inicie Visual Studio. En la ventana de inicio, seleccione Abrir una carpeta local en la columna Introducción:

    Captura de pantalla en la que se muestra cómo seleccionar la opción Abrir una carpeta local cuando se inicia Visual Studio 2022.

    Captura de pantalla en la que se muestra cómo seleccionar la opción Abrir una carpeta local cuando se inicia Visual Studio.

    Si usa el código de ejemplo del repositorio python_koans, asegúrese de seleccionar la carpeta python3 dentro de la carpeta de clonación.

    Si Visual Studio ya se está ejecutando, puede seleccionar Archivo>Abrir>Carpeta.

  2. Vaya a la carpeta que contiene el código de Python y seleccione Seleccionar carpeta:

    Captura de pantalla en la que se muestra cómo seleccionar la carpeta local que tiene el código de Python existente en Visual Studio 2022.

    Captura de pantalla en la que se muestra cómo seleccionar la carpeta local que tiene el código de Python existente en Visual Studio.

  3. Visual Studio muestra los archivos en el Explorador de soluciones en la Vista de carpetas. Puede expandir y contraer una carpeta con la flecha situada a la izquierda del nombre de carpeta:

    Captura de pantalla en la que se muestran las flechas de expandir y contraer para las carpetas del Explorador de soluciones en Visual Studio 2022.

    Captura de pantalla en la que se muestran las flechas de expandir y contraer para las carpetas del Explorador de soluciones en Visual Studio.

  4. Cuando se abre una carpeta de Python, Visual Studio crea varias carpetas ocultas para administrar la configuración relacionada con el programa. Para ver estas carpetas (y cualquier otra carpeta o archivo oculto, como la carpeta .git), seleccione la opción de la barra de herramientas Mostrar todos los archivos:

    Captura de pantalla en la que se muestra cómo ver carpetas y archivos ocultos en el Explorador de soluciones en Visual Studio 2022.

    Captura de pantalla en la que se muestra cómo ver carpetas y archivos ocultos en el Explorador de soluciones en Visual Studio.

Ejecución del programa

Después de abrir el código de Python existente en Visual Studio, puede ejecutar el programa. Para ejecutar el código, debe identificar el archivo de inicio (elemento de inicio) o el archivo de programa principal de Visual Studio para ejecutar el programa. En este ejemplo, el archivo de inicio es contemplate-koans.py.

  1. En el Explorador de soluciones, haga clic con el botón derecho en el archivo contemplate-koans.py y seleccione Establecer como elemento de inicio:

    Captura de pantalla en la que se muestra cómo configurar el archivo contemplate-koans de Python como elemento de inicio en el Explorador de soluciones en Visual Studio 2022.

    Captura de pantalla en la que se muestra cómo configurar el archivo contemplate-koans de Python como elemento de inicio en el Explorador de soluciones en Visual Studio.

    Importante

    Si el elemento de inicio no se encuentra en la raíz de la carpeta que abrió, también debe agregar una línea en el archivo JSON de configuración de inicio, tal como se describe en la sección Establecimiento de un directorio de trabajo.

  2. Para ejecutar el código, seleccione Depurar>Iniciar sin depuración o utilice la función rápida de teclado Ctrl+F5. También puede seleccionar la flecha de reproducción sólida junto al nombre del elemento de inicio en la barra de herramientas de Visual Studio. Esta opción ejecuta el código en el depurador de Visual Studio.

    En todos estos métodos de inicio, Visual Studio detecta que el elemento de inicio es un archivo de Python y ejecuta automáticamente el código en el entorno de Python predeterminado. El entorno actual se muestra a la derecha del nombre del elemento de inicio en la barra de herramientas. En el ejemplo siguiente, el entorno actual es Python 3.11 (64 bits):

    Captura de pantalla en la que se muestra cómo iniciar el programa con la depuración mediante la flecha de reproducción sólida en la barra de herramientas de Visual Studio 2022.

    En todos estos métodos de inicio, Visual Studio detecta que el elemento de inicio es un archivo de Python y ejecuta automáticamente el código en el entorno de Python predeterminado. El entorno actual se muestra a la derecha del nombre del elemento de inicio en la barra de herramientas. En el ejemplo siguiente, el entorno actual es Python 3.6 (32 bits):

    Captura de pantalla en la que se muestra cómo iniciar el programa con la depuración mediante la flecha de reproducción sólida en Visual Studio.

    Si no ve el entorno de Python actual en la barra de herramientas, seleccione Ver>Otras ventanas>Entornos de Python.

  3. Cuando se ejecuta el programa, Visual Studio abre una ventana de comandos para mostrar la salida del programa:

    Captura de pantalla de la ventana de salida que Visual Studio 2022 abre para la salida del programa desde el código de Python en ejecución.

    Captura de pantalla de la ventana de salida que Visual Studio abre para la salida del programa desde el código de Python en ejecución.

    Nota:

    Si ejecuta el programa python-koans con depuración, debe cambiar los valores del código para que el programa complete la ejecución.

  4. Puede ejecutar el código en un entorno de Python diferente:

    1. Expanda la lista desplegable Entorno de Python actual en la barra de herramientas de Visual Studio y seleccione el entorno deseado.

    2. Reinicie el programa.

  5. Cuando esté listo para cerrar la carpeta del código en Visual Studio, seleccione el Archivo>Cerrar carpeta.

Establecimiento del directorio de trabajo

De manera predeterminada, Visual Studio ejecuta un proyecto de Python abierto como una carpeta en la raíz de la misma carpeta. Sin embargo, el código de proyecto podría esperar que Python se ejecutara en una subcarpeta. Cuando el código espera encontrar archivos en diferentes ubicaciones que la configuración predeterminada reconocida por Visual Studio, puede experimentar errores al intentar ejecutar el código.

Supongamos que abre la carpeta raíz del repositorio python_koans y ve una subcarpeta denominada python3 que contiene un archivo de Python denominado contemplate-koans.py. Decide establecer el archivo python3/contemplate-koans.py como archivo de inicio. Cuando ejecute el código, verá un error que indica que no se encuentra un archivo denominado koans.txt. El error se produce porque el archivo contemplate-koans.py espera que Python se ejecute en la carpeta python3 en lugar de en la raíz del repositorio.

En tales casos, también debe agregar una línea al archivo JSON de configuración de inicio para especificar el directorio de trabajo:

  1. En el Explorador de soluciones, haga clic con el botón derecho en el archivo de inicio de Python (.py) y seleccione Agregar configuración de depuración:

    Captura de pantalla en la que se muestra cómo seleccionar la opción Agregar configuración de depuración para un archivo seleccionado en el Explorador de soluciones en Visual Studio 2022.

  2. En el cuadro de diálogo Seleccionar depurador, seleccione la opción Predeterminado de la lista y, a continuación, seleccione Seleccionar:

    Captura de pantalla en la que se muestra cómo seleccionar el depurador predeterminado en el cuadro de diálogo Seleccionar un depurador en Visual Studio 2022.

    Nota:

    Si Valor predeterminado no aparece como opción, asegúrese de seleccionar un archivo Python .py cuando seleccione el comando Agregar configuración de depuración. Visual Studio usa el tipo de archivo para determinar las opciones de depurador que se van a mostrar.

  3. Visual Studio abre un archivo denominado launch.vs.json, que se encuentra en la carpeta oculta .vs. En este archivo se describe el contexto de depuración del proyecto. Para especificar un directorio de trabajo, agregue un valor para la propiedad "workingDirectory". En el ejemplo python-koans, puede agregar la propiedad y el valor, "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. Guarde los cambios en el archivo launch.vs.json.

  5. Ejecute el programa de nuevo. La ejecución del código debe ejecutarse ahora en la carpeta especificada.

  1. En el Explorador de soluciones, haga clic con el botón derecho en el archivo de inicio de Python (.py) y seleccione Configuración de depuración y lanzamiento:

    Captura de pantalla en la que se muestra cómo seleccionar la opción Configuración de depuración y lanzamiento para un archivo seleccionado en el Explorador de soluciones en Visual Studio.

  2. En el cuadro de diálogo Seleccionar depurador, seleccione la opción Predeterminado de la lista y, a continuación, seleccione Seleccionar:

    Captura de pantalla en la que se muestra cómo seleccionar el depurador predeterminado en el cuadro de diálogo Seleccionar un depurador en Visual Studio.

    Nota:

    Si Valor predeterminado no aparece como opción, asegúrese de seleccionar un archivo Python .py cuando seleccione el comando Configuración de depuración y lanzamiento. Visual Studio usa el tipo de archivo para determinar las opciones de depurador que se van a mostrar.

  3. Visual Studio abre un archivo denominado launch.vs.json, que se encuentra en la carpeta oculta .vs. En este archivo se describe el contexto de depuración del proyecto. Para especificar un directorio de trabajo, agregue un valor para la propiedad "workingDirectory". En el ejemplo python-koans, puede agregar la propiedad y el valor, "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. Guarde los cambios en el archivo launch.vs.json.

  5. Ejecute el programa de nuevo. La ejecución del código debe ejecutarse ahora en la carpeta especificada.