---
title: Instalando várias versões da linguagem Python no Windows
date: 2025-08-05
modified: 2025-08-05
slug: instalando-varias-versoes-da-linguagem-python-no-windows
cover: https://cdn.hashnode.com/res/hashnode/image/stock/unsplash/D9Zow2REm8U/upload/e4390ba87c285ad2fe13a753b3e49454.jpeg
tags: python, windows
category: Python
lang: pt_BR
status: published
---


O [pyenv-win](https://github.com/pyenv-win/pyenv-win) é uma adaptação (fork) do [pyenv](https://github.com/pyenv/pyenv) projetada especificamente para usuários do sistema operacional [Microsoft Windows](https://www.microsoft.com/windows/).

Essa ferramenta revela-se indispensável ao lidar com diferentes exigências de versões da linguagem de programação [Python](https://www.python.org/) em um mesmo computador.

## Instalação

Para realizar a instalação da ferramenta `pyenv-win` no Microsoft Windows abra o [PowerShell](https://learn.microsoft.com/powershell/scripting/install/installing-powershell-on-windows).

Em seguida digite o seguinte comando:

```bash
Invoke-WebRequest `
-UseBasicParsing `
-Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" `
-OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
```

Assim que a instalação estiver concluída feche o PowerShell, abra novamente e execute o comando:

```bash
pyenv --version
```

Se for exibida a versão do `pyenv` a instalação está correta.

---

## Utilizando o pyenv

### Verificando as versões do Python

Para verificar **todas** as versões da linguagem de programação Python que estão disponíveis utilize o comando:

```bash
pyenv install -l
```

Já para filtrar as versões de uma determinada versão da linguagem de programação Python utilize:

```bash
pyenv install -l | findstr 3.12
```

### Instalando o Python

Após definir a versão da linguagem de programação Python que será instalada execute no terminal:

```bash
pyenv install 3.12.5
```

> 📝 Para instalar outras versões adapte o comando. Exemplo: `pyenv install 3.11.7`.

> 📝 Também é possível instalar mais de uma versão em um único comando. Exemplo: `pyenv install 3.11.9 3.12.5`

### Definindo a versão global

Para trocar entre as versões da linguagem de programação Python que estão instaladas no sistema operacional utilize o comando:

```bash
pyenv global 3.12.5
```

Já para verificar qual é versão da linguagem de programação Python está sendo utilizada pelo sistema operacional:

```bash
pyenv version
```

### Removendo uma versão

Antes de realizar a remoção de uma versão da linguagem de programação Python do sistema operacional devemos verificar todas as versões que estão instaladas, isso é feito através do comando:

```bash
pyenv versions
```

Em seguida para realizar a remoção utilize o comando:

```bash
pyenv uninstall 3.12.5
```

---

## Conclusão

O `pyenv` é uma ferramenta excelente para quem precisa utilizar mais de uma versão da linguagem de programação Python no sistema operacional (Linux, macOS e Windows).

A sua utilização juntamente com um ambiente virtual (venv, [PDM](https://pdm-project.org/latest/), [Poetry](https://python-poetry.org/), [Pipenv](https://pipenv.pypa.io/en/latest/), etc), torna o desenvolvimento com a linguagem de programação Python muito mais simples e intuitiva.