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: establézcalo manualmente o automatice todo con winget. Se necesita lo siguiente:

  • Python 3.13 : el entorno de ejecución de Python más reciente
  • Visual Studio Code : un editor de código ligero y eficaz
  • Extensión de Python para Visual Studio Code : agrega compatibilidad con lenguaje Python, depuración, linting y mucho más

El archivo de configuración de WinGet siguiente instala todo lo que se muestra anteriormente automáticamente.

Para empezar:

  1. Abra PowerShell en Terminal Windows y ejecute el siguiente comando:

    winget configure -f https://aka.ms/python-config
    
  2. Cuando se inicia la configuración, una ventana de terminal muestra los pasos de instalación y las instalaciones necesarias. Repase y, a continuación, confirme seleccionando [Y] Sí o [N] No para continuar.

  3. Se instalan las cargas de trabajo necesarias. Verifica tu configuración ejecutando python --version.

Ahora estás listo para desarrollar en 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 pueden funcionar si instala Herramientas de compilación para Visual Studio y selecciona la opción 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 el 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 python comando , es posible 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 depy.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 de py.exe solo funcionará si usa una versión de Python instalada desde python.org. Al instalar Python desde Microsoft Store, el py comando no se incluye. Para Linux, macOS, WSL y la versión de Microsoft Store de Python, debe usar el python3 comando (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 te llevará directamente a la versión más reciente del paquete de la comunidad publicada en 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 cualquier argumento de línea de comandos, se devolverá un código de error para indicar que Python no se instaló. 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 python comando tendrá prioridad sobre el acceso directo. Tenga en cuenta que otros instaladores pueden agregar python con una prioridad menor que el acceso directo integrado.

Para deshabilitar los accesos directos sin instalar Python, abra "Administrar alias de ejecución de aplicaciones" en Inicio, busque las entradas de Python "Instalador de aplicaciones" y cambie a "Desactivado".

¿Por qué no funcionan las rutas de acceso de archivo en Python al copiarlas?

Las cadenas de Python usan "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 de acceso 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?

Python usa la variable de entorno PYTHONPATH 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.

No se recomienda establecer esta variable globalmente a través de la configuración de variables de entorno, ya que cualquier versión de Python se puede usar en lugar de la que quiera usar.

¿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 contenedores mientras escala los recursos a petición.

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

La sincronización de configuración permite sincronizar la configuración de VS Code en diferentes instalaciones mediante GitHub. Si trabaja en diferentes máquinas, esto ayuda a mantener el entorno coherente entre ellas.

¿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 se asignan las teclas de método abreviado de Mac a las 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. En esta guía de transición de Mac a Windows se tratan 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 comportamiento... 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 distintas formas de compatibilidad con linting que VS Code proporciona para Python y cómo configurarla.
  • Depuración de 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.
  • Pruebas unitarias de Python: explica en segundo plano qué significan las pruebas unitarias, un tutorial de ejemplo, la habilitación de un marco de pruebas, la creación y ejecución de las pruebas, las pruebas de depuración y las opciones de configuración de pruebas.