Raspberry Pi で pyenv のインストール

pyenv は，複数のバージョンの Python をソースからビルドしてインストールし，切り替えて使うためのツールである．システムの Python を置き換えずに，別のバージョンの Python を追加できる．

【目次】

  1. 前準備
  2. Git と Python のビルドに必要なパッケージのインストール
  3. pyenv のインストールと設定
  4. pyenv を用いた Python のインストール
  5. 使用する Python の切り替え方法

【サイト内の Raspberry Pi OS 関連ページ】

小型コンピュータ Raspberry Pi について: 別ページ »にまとめ

前準備

Raspberry Pi OS のインストール

  1. Raspberry Pi OS をダウンロードし，Raspberry Pi Imager を用いて SD カードに書き込む: 別ページ »で説明
  2. Raspberry Pi OS の初期設定: 別ページ »で説明

Raspberry Pi OS の最新版は Debian 13 (trixie) をベースとしており，システムの Python は 3.13 である．公式のダウンロードページは https://www.raspberrypi.com/software/operating-systems/．

Raspberry Pi OS のシステム更新

最初に，Raspberry Pi OS のシステム更新を行っておく

端末で，次を実行 

# パッケージリストの情報を更新
sudo apt update
sudo apt -y full-upgrade
sudo apt -y autoremove
sudo apt autoclean
sudo reboot

Raspberry Pi OS の初期設定

Raspberry Pi OS の初期設定については， 「Raspbian の初期設定」のページで説明している．

Git と Python のビルドに必要なパッケージのインストール

pyenv は Python をソースからビルドする．そのため，ビルドに必要なパッケージをあらかじめインストールしておく．次のコマンドを実行． 

# パッケージリストの情報を更新
sudo apt update
sudo apt -y install git make build-essential libssl-dev zlib1g-dev \
  libbz2-dev libreadline-dev libsqlite3-dev curl libncursesw5-dev xz-utils \
  tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev libzstd-dev

このパッケージ一覧は，pyenv の公式ドキュメント Suggested build environment に基づく．

pyenv のインストールと設定

  1. pyenv のダウンロード (Download pyenv) 
    cd /tmp
git clone https://github.com/pyenv/pyenv.git ~/.pyenv
  2. pyenv の更新 (Update pyenv)

    インストール済みの pyenv を最新版に更新するときも，次のコマンドを実行する． 

    cd ~/.pyenv
git pull
  3. pyenv の設定 (Settings of pyenv)

    対話的シェル用の ~/.bashrc と，ログインシェル用の ~/.profile の両方に設定を追記する． 

    echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init - bash)"' >> ~/.bashrc
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.profile
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.profile
echo 'eval "$(pyenv init - bash)"' >> ~/.profile
exec "$SHELL"
  4. pyenv が動作することの確認

    バージョン番号が表示されれば，設定は完了している． 

    pyenv --version

pyenv を用いた Python のインストール

  1. 新しく端末を開く
  2. システムの python のバージョンの確認 
    python3 --version

    実行結果の例

  3. インストールできる Python のバージョンの確認 
    pyenv install -l
  4. インストールできる Python 3.13 のバージョンの確認 
    pyenv install -l | grep 3.13
  5. Python 3.13 のビルドとインストール (pyenv を使用)

    バージョン番号を 3.13 のように途中まで指定すると，その系列の最新版がインストールされる．ソースからのビルドを行うため，Raspberry Pi では完了までに時間がかかる． 

    pyenv install 3.13
  6. 確認 
    pyenv versions

    インストール済みの Python の一覧が表示される．system は，OS に付属の Python を指す．

使用する Python の切り替え方法

使用する Python の切り替えは 次のコマンドで行う