Go to Qiita Advent Calendar 2024 Top
LoginSignup
1
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

@Ryo-0131(Citrus Tech)

HomebrewでPythonをインストールし、pyenvとvenvを使用する方法（Mac M1）

Posted at

概要

  • Mac M1にて、HomebrewでPythonをインストールしたので、表示されたエラーメッセージなども含めてその方法を記しておく。

環境・前提

  • Mac

    • 機種ID：MacBookPro18,3
    • macOS：Monterey
    • チップ：Apple M1 Pro
    • メモリ：16GB

  • Pythonをインストールする方法は以下の3通りがあるが、今回はHomebrewを利用したインストールとする。Homebrewとは、ソフトウェアの導入をシンプルに行うことができるパッケージ管理システム。

    • Homebrew版Python環境（pipでパッケージ管理が可能）
    • 公式版Python環境（pipによるパッケージ管理が可能・Windows版は推奨）
    • AnacondaやMiniconda（condaによるパッケージ管理・pipと併用できない）

  • 元々、Python勉強用の講座でanaconda3を導入していたが、pipで管理したいことから、anacondaディレクトリを削除してから実施することとした。

  • 複数バージョンのPythonを利用していくことを考え、pyenvというソフトウェアもインストールする。pyenvとは、Pythonのバージョン管理を行うソフトウェア。

  • 仮想環境ごとにpipでパッケージ管理して作業することも考え、venvを使用してみることとする。venvとは、Python の仮想実行環境を作成するための標準モジュール。

    • Python3.3以降では「venv」が同梱されている。それ以前は、サードパーティ製virtualenvが使われることが多かったらしいです。

Homebrewインストール手順

  • 公式サイトのHomebrewの指示に従ってインストール

Pythonインストール手順

  • ターミナルで以下コマンドを実行する。
brew install python3

ファインダーの検索窓で 「ターミナル」 と検索
出てきたターミナルを右クリックして、 「情報を見る」 をクリック
「Rosseta使用して開く」 （またはRosseta2） 左横のチェックボックスにチェックを入れる
ターミナルを再起動

  • 上記実施後、python3と打てばpython入力画面になること確認。

pyenvのインストール

  • pyenvは、複数のバージョンのPythonを併用したい場合に便利。
    • ソースのgithubはこちら：pyenv
  • brew install pyenvでインストール実施したところ、以下エラーが表示された。
error: Not a valid ref: refs/remotes/origin/master

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

  • 最後にsource ~/.bashrcでbashに反映させる。

    • zshrcを利用する場合は、bashrcの部分を書き換えてください

  • which pyenvと入力すると以下が表示された。

pyenv () {
local command
command="${1:-}"
if [ "$#" -gt 0 ]
then
shift
fi
case "$command" in
(rehash | shell) eval "$(pyenv "sh-$command" "$@")" ;;
(*) command pyenv "$command" "$@" ;;
esac
}
  • 翌日に対応しようと思って翌日PCを立ち上げてwhich pyenvをすると、無事に出てきた。再起動の問題か。
/usr/local/bin/pyenv

バージョンを指定したPythonのインストール

  • pyenv install 3.8.7とpyenv install 3.9.9を実施
  • pyenv versionsと入力すると以下確認できる
  system
  3.8.7
* 3.9.9 (set by /Users/xxxxxxx/.pyenv/version)

alias python='python3'
alias pip='pip3'
  • ただし、これはエイリアスでの対応であって、抜本的な解決ではない。翌日また対応策を調べよう。
    ↓
  • homebrewの保存先をviを利用して以下に変更
/opt/homebrew/bin/brew
  • brewをアップグレードする
brew update
brew upgrade
  • brew upgrade後、以下エラーメッセージが表示された
Error: Cannot install under Rosetta 2 in ARM default prefix (/opt/homebrew)!
To rerun under ARM use:
    arch -arm64 brew install ...
To install under x86_64, install Homebrew into /usr/local.

  • やっぱりM1チップはRossettaが関係してくるっぽい。「Rosseta使用して開く」 についてはチェックを外して、再度ターミナル開いて実施したらエラーメッセージは表示されなく無くなった。

  • python3の場所を以下で確認。

/usr/bin/python3

  • あれ、Homebrew以下にない模様。

  • もう一度、brew install python3を実施、bashでPATHを更新し、which python3を実行したところ、

/opt/homebrew/bin/python3

となった。homebrew以下に置けたみたい。

which brewでもちろん以下を確認。

/opt/homebrew/bin/brew
  • python -Vコマンドも実行できていること確認。

グローバルとローカルの指定

  • 使用したいPythonのバージョンが3.9.9の場合、以下コマンドを実行する。これにより、どこのディレクトリでも3.9.9が呼び出されるようになる。
pyenv global 3.9.9
  • 特定のディレクトリ下でのみ（=ローカルで）、例えば3.8.7を使用したい場合は、cdで対象ディレクトリに移動後、以下localオプションを実行する。
pyenv local 3.8.7
  • globalとlocalのバージョンは以下で確認可能
    • pyenv global
    • pyenv local
    • local設定のほうがglobalより優先される

globalが反映されない場合の対処法

  • globalでバージョン指定したものが、python --versionで反映されないことがありました。その時は、[Dev] pyenvを使って Python のバージョン変更ができないときのサイトを参考に、以下コマンドを追記したら直りました。また、そもそも通したPATHが合っているかどうかは、pyenv initで# the following to以降のパスを確認してから実行した方が良いと思います。
if command -v pyenv 1>/dev/null 2>&1; then
  eval "$(pyenv init -)"
fi

仮想環境（venv）の使用方法

  • venvにより、実際に使っているpackage listをvenv下にインストールすることができる。これにより、実際に使っているpackageの不具合などを検証できたり、誰かと同じpackageの状態で作業できたりすることができることが利点。

  • requirements.txtに一覧さえ作っておけば、誰でもすぐに同じpackage listの環境が作れるのが良い。

  • 仮想環境作成

    • python3 -m venv env
    • もしくはpython -m venv env
    • envは仮想環境名。実行後、envディレクトリが自動生成される

  • 仮想環境起動（有効化・アクティベート）

    • source env/bin/activate
    • PATHの内容をbinに置き換えることでが、Python系コマンドは仮想環境内で動作するようになる

  • 　(env) xxxx@xxxxxxxx ~ % と表示されれば、起動できている

  • ライブラリのインストール

    • pip install -r requirements.txt
    • requirementがない場合はインストールされない
    • pip freeze > requirements.txtコマンドで、自動生成も可能

  • 無効化する場合はdeactivateを実行する

1
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
1
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?