Cómo comprobar la versión de Python: Windows, macOS y Linux

Saber qué versión de Python estás utilizando es más importante de lo que parece. Muchas bibliotecas y marcos dependen de versiones específicas de Python, y el código puede comportarse de manera diferente en distintas versiones. La ejecución de scripts en una versión no compatible o inesperada suele provocar errores de instalación o de tiempo de ejecución que son difíciles de diagnosticar.

En esta guía, te mostraré formas sencillas y fiables de comprobar tu versión de Python en los sistemas operativos, entornos y configuraciones más comunes. Si estás empezando con Python, te recomiendo que realices nuestro curso Introducción a Python, que cubre habilidades como tipos de datos, listas, funciones básicas y paquetes.

Cómo comprobar la versión de Python desde la línea de comandos

La forma más habitual de comprobar tu versión de Python es utilizando el terminal de tu ordenador (Mac/Linux) o el símbolo del sistema/PowerShell (Windows).

Usando Python --version

Este comando pregunta al sistema qué intérprete de Python está asociado al comando python e imprime su versión.

python --version

Este comando funciona en la mayoría de los sistemas si python está correctamente configurado en tu PATH. Sin embargo, el comando podría fallar si python apunta a Python 2 o no existe en la ruta PATH.

Usando python3 --version

Algunos sistemas, especialmente macOS y Linux, requieren que utilices python3 para hacer referencia explícita a Python 3. Esto se debe a que la mayoría de los ordenadores modernos vienen con Python 2 y Python 3 instalados.

python3 --version

En Windows, es posible que este comando no funcione a menos que Python se haya instalado añadiendo explícitamente python3.

Usando Python -V (sintaxis alternativa)

Este comando es una versión abreviada de « python --version ».

python -V

El comando produce el mismo resultado, pero se comporta de forma ligeramente diferente en algunos entornos. En algunos entornos antiguos o terminales específicos, el número de versión puede enviarse a stderr (error estándar) en lugar de a stdout (salida estándar).

A simple vista, parece lo mismo en la pantalla, pero puede ser importante en los scripts si intentas «canalizar» ese texto a otro archivo o programa.

Cómo comprobar la versión de Python dentro de Python

A veces, es posible que quieras comprobar la versión de Python desde un script o una sesión interactiva. Esto resulta útil cuando deseas que tu código confirme su entorno de ejecución para facilitar la depuración de errores en tu script.

Puedes acceder a los detalles de la versión importando la biblioteca integrada sys. El código siguiente muestra la cadena completa de la versión de Python junto con los detalles de compilación.

-- Check Python version
import sys
print(sys.version)

Este método resulta útil a la hora de escribir lógica condicional que depende de la versión de Python y registrar información sobre el tiempo de ejecución.

Comprobación de la versión de Python en entornos virtuales

Dado que los entornos virtuales (venv y conda) se utilizan para proyectos específicos, pueden usar una versión de Python diferente a la predeterminada en tu sistema. Si creas un entorno virtual, este viene con un intérprete de Python específico, y al activar el entorno se cambia el ejecutable de Python que se utiliza.

Para confirmar la versión activa de Python en tu entorno virtual, primero actívala y, a continuación, ejecuta el siguiente comando:

python --version

Si la versión que aparece no es la que esperabas, es posible que el entorno se haya creado con una instalación diferente de Python o que actualmente no esté activado.

Te recomiendo utilizar nuestra hoja de referencia de Conda cuando quieras echar un vistazo a la gestión de paquetes y al trabajo con el entorno conda.

Cómo comprobar la versión de Python en diferentes sistemas operativos

Cada sistema operativo maneja Python de forma ligeramente diferente. A continuación se explica cómo comprobar la versión de Python en cada uno de ellos:

Ventanas

Para comprobar la versión de Python en Windows, puedes utilizar:

python --version

O bien:

py --version

Las desventajas de este método son que tener varias instalaciones de Python puede causar confusión, o que es posible que no se reconozca python debido a una configuración incorrecta de PATH. Además, el lanzador py puede apuntar a una versión diferente a python, por lo que fallará.

macOS y Linux

En el caso de macOS y Linux, debes tener en cuenta que el sistema puede incluir una versión de Python preinstalada que utiliza internamente el sistema operativo. Además, python puede hacer referencia a Python 2 o puede que ni siquiera exista, mientras que python3 suele apuntar a la versión Python 3 instalada por el usuario.

Puedes comprobar la versión de Python en macOS o Linux utilizando:

python --version

O utiliza python3 para evitar usar accidentalmente una versión obsoleta o gestionada por el sistema de Python.

python3 --version

Problemas comunes al comprobar la versión de Python

Al comprobar la versión de Python, es posible que te encuentres con cierta confusión, especialmente cuando intervienen múltiples herramientas y entornos:

• «Comando Python no encontrado»: Esto suele significar que Python no está instalado o que no se ha añadido a la ruta PATH del sistema. En algunos sistemas, solo está disponible python3, no python.

• Varias versiones de Python instaladas: Es habitual tener más de una versión de Python en la misma máquina. Diferentes comandos como python, python3 y py pueden apuntar a diferentes intérpretes, lo que puede hacer que las comprobaciones de versión parezcan inconsistentes.

• El comando devuelve una versión inesperada: Es posible que estés comprobando una instalación de Python diferente a la que deseabas. Esto suele ocurrir cuando no se activa un entorno virtual o cuando el orden PATH da prioridad a otro ejecutable de Python.

• Incompatibilidad entre IDE y versión del terminal: Tu IDE, como VS Code o PyCharm, puede estar configurado para utilizar un intérprete de Python diferente al de tu terminal. El código que se ejecuta dentro del IDE utiliza su intérprete configurado, y puede que no sea necesariamente el que devuelve python --version en tu línea de comandos.

Mejores prácticas para gestionar versiones de Python

Para evitar sorpresas relacionadas con las versiones, recomiendo utilizar la siguiente lista de verificación:

• Comprueba siempre la versión de Python antes de instalar las dependencias: Ejecuta siempre « python --version » antes de ejecutar un comando como « pip install ». Esto garantiza que no instales accidentalmente bibliotecas en la versión incorrecta.

• Sé explícito con las órdenes: Si sabes que necesitas Python 3, utiliza python3 en lugar de dar por sentado que python apunta a la versión correcta.

• Utiliza entornos virtuales de forma sistemática: Utiliza un entorno virtual (venv) para cada nuevo proyecto. Esto mantiene la versión y las bibliotecas de tu proyecto aisladas del resto del sistema para garantizar que cada una utilice la versión correcta de Python y las dependencias adecuadas.

• Evita depender del sistema Python para los proyectos: El Python gestionado por el sistema suele ser utilizado por el sistema operativo y no debe modificarse. Instala siempre tu propia versión de Python para tus proyectos a fin de obtener los resultados deseados.

Conclusión

Especificar claramente qué versión de Python estás utilizando te ayuda a evitar problemas comunes de configuración, reduce la confusión y ahorra tiempo al instalar paquetes o depurar errores.

Para comprender Python a fondo, puedes obtener más información en nuestro curso Fundamentos de datos de Python y Fundamentos de programación en Python. Por último, personalmente recomiendo nuestro programador de Python para aprender sobre pruebas de código y control de versiones en el scraping web y el desarrollo de paquetes.