【2022年版】WindowsにPythonバージョン管理『pyenv』をインストールする方法

どうも、白夜霧（@KiRi_Byakuya）です。

今回は、Pythonのバージョン管理ができる「pyenv」をWindowsにインストールする方法を記載。※自分用。

当初「pyenv」はWindowsでは使用できませんでした。ただ、今は公式がWindows向けの「pyenv-win」をリリースしてWindowsでも問題なく使えます。

1 「pyenv」をWindowsにインストールする手順
- 1.1 インストール方法
2 「pyenv」のPATH（環境変数）を追加する
- 2.1 PATHの確認
3 「pyenv-win」の使い方
- 3.1 おすすめのPython入門書

「pyenv」をWindowsにインストールする手順

GitHub / pyenv-win

インストール方法

以下の４つの中から自分の環境に合ったものを選択して、インストールを行う。

①pipでインストール
②zipファイルからインストール
③Gitからクローンをダウンロードしてインストール
④Windows用パッケージ管理ソフト「Chocolatey」でインストール

①はPythonがインストール済み前提。Pythonをまだインストールしていないのであれば、Gitからのインストールが手っ取り早いかな？詳細は公式Githubの「installation」を確認して確認して下さい。

私は既にpythonをインストール済みなので①のpipからインストールします。

: 【Python】WindowsにPythonをインストールする。
どうも、白夜霧（@KiRi_Byakuya）です。今回はWindows ...
続きを見る

step
1pipのアップデート

やらなくてもいいけど、最新じゃないとインストール完了後に警告が出る。※管理者権限で実行。

pip install --upgrade pip

アップグレードしたら下記警告（アクセス拒否）が表示された。


pip install --upgrade pip
Requirement already satisfied: pip in c:\users\one_n\appdata\local\programs\python\python310\lib\site-packages (21.2.4)
Collecting pip
  Using cached pip-22.0.3-py3-none-any.whl (2.1 MB)
Installing collected packages: pip
  Attempting uninstall: pip
    Found existing installation: pip 21.2.4
    Uninstalling pip-21.2.4:
      Successfully uninstalled pip-21.2.4
ERROR: Could not install packages due to an OSError: [WinError 5] アクセスが拒否されました。: 'C:\\Users\\kiri\\AppData\\Local\\Programs\\Python\\Python310\\~cripts\\pip.exe'
Consider using the `--user` option or check the permissions.

要求された通り、--userを追加して再度アプデを要求してみたら、問題なく最新verにアプデされていた。どういうこと？


pip install --upgrade pip --user
Requirement already satisfied: pip in c:\users\kiri\appdata\local\programs\python\python310\lib\site-packages (22.0.3)

step
2pyenvのインストール

※コマンドプロンプトの場合

pip install pyenv-win --target %USERPROFILE%\.pyenv

※PowerShell（or Git Bash）の場合

pip install pyenv-win --target $HOME\.pyenv

「pyenv」のPATH（環境変数）を追加する

コード,Programming,プログラミング

pyenv-winのPATH（環境変数）を設定します。

これも公式の支持通りやればOK（pyenv-win#finish-the-installation）。使用するのは「PowerShell」か「Windows Terminal」のどっちか。コマンドプロンプトはダメ。

環境変数を設定

上から順番に設定する。


[System.Environment]::SetEnvironmentVariable('PYENV',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")


[System.Environment]::SetEnvironmentVariable('PYENV_ROOT',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")


[System.Environment]::SetEnvironmentVariable('PYENV_HOME',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")


[System.Environment]::SetEnvironmentVariable('path', $env:USERPROFILE + "\.pyenv\pyenv-win\bin;" + $env:USERPROFILE + "\.pyenv\pyenv-win\shims;" + [System.Environment]::GetEnvironmentVariable('path', "User"),"User")