プログラミング

Pythonのバージョンを切り替える pyenv の使い方

投稿日:2020年4月6日 更新日:

1. pyenv とは?

pyenv は、Python のバージョンを切り替えるコマンドラインのツールです。

もう少し具体的にいうと、python, pip, ipython, pydoc などの Pythonに関する各コマンドがまとめて切り替わります。また、pip コマンドでインストールするライブラリもバージョン毎に別管理になります。そのため、「Python のバージョンを切り替える」ではなく、「Pythonの環境を切り替える」と表現されることもあります。

Python のバージョンには 2系と3系があるのですが、長年どちらも使われてきました。そのため、Pythonを利用しているプログラム(ツール)によって、どちらのバージョンが必要なのかが割とばらばらだったりします。このような場合に、バージョンが簡単に切り替えられると非常に便利です。もちろん、Python のプログラムを自分で書く場合にも便利です。

※ 2系は 2020年4月でサポートが終了します。

※ 更に高度なことができる pipenv というツールもあります。

2. pyenv の導入

環境

Ubuntu 18.04 (on WSL) での pyenv 導入手順について説明します。

導入手順

(1) Ubuntu 18.04 のターミナルエミュレータを開きます。

(2) 以下のコマンドを実行し、ホームディレクトリ直下に .pyenv ディレクトリを作成します。

$ git clone https://github.com/pyenv/pyenv.git ~/.pyenv

pyenv コマンドで導入する Python は、このディレクトリ内にインストールされます。

(3) ~/.profile ファイルに以下を記述します。

if [ -d "${HOME}/.pyenv" ]; then
    export PYENV_ROOT="${HOME}/.pyenv"
    export PATH="$PYENV_ROOT/bin:$PATH"
    if command -v pyenv 1>/dev/null 2>&1; then
        eval "$(pyenv init -)"
    fi
fi

(4) virtualenvwrapper をインストールします。

$ pip install virtualenvwrapper
  • これをインストールしないと、ターミナル起動時に警告が表示されます。

(5) ターミナルを開き直します。

3. pyenv を使う

インストールできるバージョン確認する

$ pyenv install -l

特定のバージョンのPythonをインストールする

$ pyenv install バージョン
$ pyenv rehash

インストール済みのバージョンを表示する

$ pyenv versions

利用するバージョンを変更する(グローバル)

$ pyenv global バージョン

今いるディレクトリで使用するバージョンを変更する

$ pyenv local バージョン

ディレクトリ固有のバージョン設定をクリアする

$ pyenv local --unset

インストール済みのバージョンをアンインストール

$ pyenv uninstall バージョン

4. おわりに

上にも書いた通り、2020年4月で 2系のサポートが切れるので、今後は 3系の割合が更に増えていくでしょう。

とはいえ、2系にしか対応していない Python製のプログラムを使いたい場合や、3系であっても細かいバージョンを切り替えたい場合には、依然として pyenv のようなツールは便利であり続けるはずです。

5. 参考

📂-プログラミング

執筆者:labo


comment

メールアドレスが公開されることはありません。

関連記事

Web Components

Web Components: カスタム属性の利用方法

Web Components を使ってカスタム要素を作成し、そのタグを記述する際に、独自の属性を利用する方法について説明します。

QRコードの画像ファイルから内容を読み取るWebページを作りました

目次1. はじめに2. スクリーンショット3. URL4. 操作と内容5. ソースコード6. 参考情報 1. はじめに QRコードの画像ファイルから内容を読み取る を作りました。 2. スクリーンショ …

Canvas と WebGL を使ったサンプルページを作りました

Canvas と WebGL を使ったサンプルページを作りました 目次1. スクリーンショット2. デモページ3. 内容4. ソースコード5. 参考情報 1. スクリーンショット スクリーンショット …

Web Programming

IntersectionObserver API を使ったテストページを作成しました

IntersectionObserver API を使ったテストページを作成しました。 IntersectionObserver API は、ウェブページ上のある要素が見える範囲 (viewport) …

JavaScript でスロットマシーンを作ってみました(Canvas版)

JavaScript でスロットマシーンを作ってみました。 前回 とは違い、今回は Canvas を使っています。 目次1. スクリーンショット2. デモページ3. 内容4. ソースコード5. 参考情 …