Compartir a través de

Configuración del entorno de desarrollo de Python en Windows

Preparar el entorno de Python en Windows en cuestión de minutos: instale desde la línea de comandos con winget o establézcalo manualmente. Se necesita lo siguiente:

  • Python: tiempo de ejecución de Python estable actual (3.14 o posterior)
  • Visual Studio Code: un editor de código ligero y eficaz
  • Extensión de Python para Visual Studio Code: agrega compatibilidad para el lenguaje Python, depuración, linting y mucho más

  1. Abra PowerShell en Terminal Windows e instale Python:

    winget install Python.Python.3.14

  2. Instale Visual Studio Code:

    winget install Microsoft.VisualStudioCode

  3. Cierre y vuelva a abrir PowerShell y compruebe que Python está instalado:

    python --version

  4. Abra VS Code e instale la extensión Python desde VS Code Marketplace.

Ya está listo para el desarrollo en Python.

Comienza con Python

Preguntas más frecuentes

Problemas para instalar un paquete con pip install

Hay varias razones por las que se producirá un error en una instalación; en muchos casos, la solución correcta es ponerse en contacto con el desarrollador del paquete.

Una causa común de problemas es intentar instalar en una ubicación que no tiene permiso para modificar. Por ejemplo, la ubicación de instalación predeterminada podría requerir privilegios administrativos, pero de forma predeterminada Python no las tendrá. La mejor solución es crear un entorno virtual e instalarlo allí.

Algunos paquetes incluyen código nativo que requiere que se instale un compilador de C o C++. En general, los desarrolladores de paquetes deben publicar versiones precompiladas, pero a menudo no lo hacen. Algunos de estos paquetes podrían funcionar si instalar herramientas de compilación para Visual Studio y seleccionar la opción de C++, pero en la mayoría de los casos deberá ponerse en contacto con el desarrollador del paquete.

Siga la explicación sobre StackOverflow.

Problemas para instalar pip con WSL

Al instalar un paquete (como Flask) con pip en Subsistema de Windows para Linux (WSL o WSL2), por ejemplo, python3 -m pip install flask, puede producirse un error similar al siguiente:

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 menos que ejecute un firewall de terceros, la solución probable es simplemente volver a instalar pip.

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
¿Qué es py.exe?

Es posible que termine con varias versiones de Python instaladas en la máquina porque está trabajando en diferentes tipos de proyectos de Python. Dado que todos usan el comando python, puede que no sea obvio qué versión de Python está usando. Como estándar, se recomienda usar el python3 comando (o python3.7 para seleccionar una versión específica).

El iniciador py.exe seleccionará automáticamente la versión más reciente de Python que ha instalado. También puede usar comandos como py -3.7 para seleccionar una versión determinada o py --list para ver qué versiones se pueden usar. Sin embargo, el iniciador py.exe solo funcionará si utiliza una versión de Python instalada desde python.org. Al instalar Python desde la Tienda de Microsoft, el comando py no está incluido. Para Linux, macOS, WSL y la versión Microsoft Store de Python, debe usar el comando python3 (o python3.7).

¿Por qué al ejecutar python.exe se abre Microsoft Store?

Para ayudar a los nuevos usuarios a encontrar una buena instalación de Python, hemos agregado un acceso directo a Windows que le llevará directamente a la versión más reciente del paquete de la comunidad publicado en el Microsoft Store. Este paquete se puede instalar fácilmente, sin permisos de administrador, y reemplazará los comandos predeterminados python y python3 por los reales.

Al ejecutar el archivo ejecutable de acceso directo con los argumentos de la línea de comandos, se devolverá un código de error para indicar que no se instaló Python. Esto es para evitar que los archivos por lotes y los scripts abran la aplicación de la tienda cuando probablemente no estaba previsto.

Si instala Python con los instaladores de python.org y selecciona la opción "agregar a PATH", el nuevo comando python tendrá prioridad sobre el acceso directo. Tenga en cuenta que otros instaladores pueden agregar python con una prioridad menor que el acceso directo integrado.

Puede deshabilitar los alias de acceso directo sin instalar Python abriendo "Administrar alias de ejecución de aplicaciones" en Inicio, buscando las entradas del "Instalador de aplicaciones" de Python y cambiándolas a "Desactivado".

¿Por qué no funcionan las rutas de acceso de archivo en Python cuando las copio y pego?

Las cadenas de Python utilizan "secuencias de escape" para caracteres especiales. Por ejemplo, para insertar un nuevo carácter de línea en una cadena, escriba \n. Dado que las rutas de acceso de archivo en Windows usan barras diagonales inversas, es posible que algunas partes se conviertan en caracteres especiales.

Para pegar una ruta como una cadena en Python, agregue el prefijo r. Esto indica que es una raw cadena y no se usará ningún carácter de escape excepto " (es posible que tenga que quitar la última barra diagonal inversa en la ruta de acceso). Por lo tanto, la ruta de acceso podría ser similar a la siguiente: r"C:\Users\MyName\Documents\Document.txt"

Al trabajar con rutas de acceso en Python, se recomienda usar el módulo pathlib estándar. Esto le permitirá convertir la cadena en un objeto Path enriquecido que puede realizar manipulaciones de ruta de acceso de forma coherente, tanto si utiliza barras diagonales como barras invertidas, haciendo que su código funcione mejor en diferentes sistemas operativos.

¿Qué es PYTHONPATH?

La variable de entorno PYTHONPATH la usa Python para especificar una lista de directorios desde los que se pueden importar los módulos. Cuando se ejecuta, puede inspeccionar la sys.path variable para ver qué directorios se buscarán al importar algún elemento.

Para establecer esta variable desde el símbolo del sistema, use: set PYTHONPATH=list;of;paths.

Para establecer esta variable desde PowerShell, use: $env:PYTHONPATH='list;of;paths' justo antes de iniciar Python.

Establecer esta variable globalmente a través de las Variables de entornono es recomendado, ya que se puede utilizar en cualquier versión de Python en lugar de la que pretende utilizar.

¿Dónde puedo encontrar ayuda con el empaquetado y la implementación?

Docker: la extensión VSCode le ayuda a empaquetar e implementar rápidamente con Dockerfile y plantillas de docker-compose.yml (genere los archivos de Docker adecuados para el proyecto).

Azure Kubernetes Service (AKS) le permite implementar y administrar aplicaciones en contenedor mientras escala los recursos a petición.

¿Qué ocurre si necesito trabajar en diferentes máquinas?

VS Code tiene Settings Sync que le permite compartir su configuración, atajos de teclado, extensiones y mucho más a través de diferentes dispositivos utilizando su cuenta de GitHub o de Microsoft. No se necesita ninguna extensión.

¿Qué ocurre si estoy acostumbrado a usar PyCharm, Atom, Sublime Text, Emacs o Vim?

La extensión Keymaps de VSCode puede hacer que su entorno sea más familiar.

Cómo asignar teclas de método abreviado de Mac a teclas de método abreviado de Windows?

Algunos de los botones de teclado y los métodos abreviados del sistema son ligeramente diferentes entre una máquina Windows y macintosh. Este Mac para Windows guía de transición cubre los conceptos básicos.

¿Dónde puedo obtener más información sobre el uso de Python en VS Code?
  • Edición de Python en VS Code: Obtenga más información sobre cómo aprovechar la compatibilidad con autocompletar e IntelliSense de VS Code para Python, incluido cómo personalizar su funcionamiento... o simplemente apagarlos.
  • Linting Python: Linting es el proceso de ejecución de un programa que analizará el código para detectar posibles errores. Obtenga información sobre las diferentes formas de compatibilidad con linting que VS Code proporciona para Python y cómo configurarla.
  • Debugging Python: La depuración es el proceso de identificación y eliminación de errores de un programa informático. En este artículo se explica cómo inicializar y configurar la depuración para Python con VS Code, cómo establecer y validar puntos de interrupción, adjuntar un script local, realizar la depuración para diferentes tipos de aplicaciones o en un equipo remoto y algunos problemas básicos.
  • Unit testing Python: trata algunos aspectos en segundo plano que explican qué significan las pruebas unitarias, un tutorial de ejemplo, la habilitación de un marco de pruebas, la creación y ejecución de pruebas, las pruebas de depuración y la configuración de pruebas.
  • Last updated on