O pyenv-win é uma adaptação (fork) do pyenv projetada especificamente para usuários do sistema operacional Microsoft Windows.

Essa ferramenta revela-se indispensável ao lidar com diferentes exigências de versões da linguagem de programação Python em um mesmo computador.

Instalação

Para realizar a instalação da ferramenta pyenv-win no Microsoft Windows abra o PowerShell:

Em seguida digite o seguinte comando:

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:

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:

pyenv install -l

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

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:

pyenv install 3.12.1

📝 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.7 3.12.1

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:

pyenv global 3.12.1

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

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:

pyenv versions

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

pyenv uninstall 3.12.1

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, Poetry, Pipenv, etc), torna o desenvolvimento com a linguagem de programação Python muito mais simples e intuitiva.