macOSにPythonをpyenvでインストール＆環境構築する方法について詳しく解説します。
「macOS標準のPython」を使わない方が良い理由
macOSには「(/usr/bin/python3」に最初からPythonがインストールされています（以下、「macOS標準のPython」という）。
しかし、「macOS標準のPython」は以下の理由からプログラミングには使用しないことが良いとされています。
| 理由 | 説明 |
|---|---|
| バージョンが古い | 「macOS標準のPython」はシステムメンテナンス用のスクリプトなどに使用されています。「macOS標準のPython」のアップグレード等をするとmacOSの内部動作が正常に動かなくなる恐れがあります。 |
| パッケージの更新やインストールに管理者権限（sudo）が必要 | macOSには、SIP（System Integrity Protection） という仕組みがあり、 「/usr/bin」などのディレクトリは 書き換え禁止 になっています。簡単にいうと、Apple は「ここにあるものは重要だから安易に触るな」と明示しています。 |
よって、「macOS標準のPython」は使わず、別途Pythonをインストールして使う方法が望ましいです。今回は、PythonをHomebrewでインストールする方法を詳しく解説します。
動画解説板
「macOS標準のPython」の状態を確認
別途Pythonをインストールする前に念の為に「macOS標準のPython」の状態を確認しておきましょう。
① ターミナルを開き、以下のコマンドを実行します。
python3 --version
which python3
② あとで「どれがどの Python？」で迷わないように、出力結果をメモしておきましょう。
/usr/bin/python3と出る → macOS 標準の Python を使っている状態/opt/homebrew/bin/python3など → Homebrew 版が入っている可能性あり
Homebrewのインストール
① ターミナルで以下のコマンドを実行し、Homebrew が入っているかチェックします。
brew --version
② バージョンが表示されればOKです。「command not found」と出たら、Homebrew をインストールする必要があります。以下ページを参考に導入してください。
HomebrewでPythonをインストール
Homebrew で Python をインストールする手順は以下のとおりです。
① ターミナルで以下のコマンドを実行し、Pythonをインストールします。
brew install python
② これで最新の安定版 Python（通常は Python 3.x）が入ります。
③ ターミナルで以下のコマンドを実行し、インストールされた Python の場所とバージョンを確認しましょう。
which python3
python3 --version
⑤ Python 3.14.0 のようにhomebrewでインストールしたバージョンが表示されれば成功です。もし、Python 3.9.6 のように「macOS標準のPython」のバージョンが表示された場合、「Users/ユーザー名/.zshrc」ファイルの先頭に以下2行を追記し、ターミナルを開き直して再度「python3 –version」を実行しましょう。
export PATH="/opt/homebrew/bin:$PATH"
export PATH="/opt/homebrew/sbin:$PATH"
Homebrew がインストールした 新しい Python（3.14.2） が /opt/homebrew/bin/python3 にあるため、/opt/homebrew/bin を PATH の 先頭 に追記することで、macOS が最初に見つける Python を 新しいものに切り替え ています。
④ ターミナルで以下のコマンドを実行し、念のためpip の バージョンも確認しましょう。
（Homebrew 版 Python には pip が最初から付いているので、そのまま使えます）
pip3 --version
プログラムの作成と実行
環境構築ができたら、実際に Python プログラムを動かしてみましょう。ここでは、もっとも基本的な、テキストエディタで Python ファイルを作成し、それをターミナルにドラッグ＆ドロップして実行する方法を紹介します。
① テキストエディタ（VS Code、メモ帳、CotEditor など何でもOK）で新しいファイルを作成します。以下の内容を書き込みます。
print("こんぴこー！")
② ファイル名を main.py として保存します。 保存場所はどこでも構いません（例：デスクトップやプロジェクトフォルダ）。
③ ターミナルを開き、以下のコマンドを実行します。
python3 [main.pyのファイルパス]
※ 「python3」と入力して半角スペースを入れたあと、作成した main.py を ターミナルのウィンドウにドラッグ＆ドロップすると、ファイルパスが自動入力されます。
すると、ファイルのフルパスが自動で入力されます。
④ 以下の表示がされたら、プログラムが正常に実行されています。
こんぴこー！
VS Codeでプログラムを作成して実行
Visual Studio Code（VS Code） を使うと、ターミナルを開かなくても ワンクリックで Python を実行できます。毎回ドラッグ＆ドロップする必要がなくなるので、開発がとても快適になります。VS Codeのインストールからプログラムの作成と実行までの手順を解説します。
VS Codeのインストール
① 公式サイト（https://code.visualstudio.com/）にアクセスし、macOS 版をダウンロードします。
② ダウンロードした VSCode.app を「アプリケーション」フォルダに移動します。
③ アプリケーションフォルダから Visual Studio Code を起動します。
Python 拡張機能のインストール
VS Code は拡張機能を入れることで Pythonプログラムを快適に扱えるようになります。
① VS Code 左側の「四角いアイコン（拡張機能）」をクリックします。
② 検索欄に Python と入力 します。
③ Microsoft 製の Python 拡張機能をインストール
これで、コード補完・エラー表示・実行ボタンなどが使えるようになります。
Python ファイルを作成する
① VS Code で新規ファイルを作成
② 以下の内容を書きます。
print("Hello, Python!")
③ main.py という名前で保存します。
保存場所はどこでも OK（デスクトップでもプロジェクトフォルダでも大丈夫）。
VS Code でワンクリック実行
Python ファイルを開くと、VS Code の右上に ▶ Run Python File ボタンが表示されます。
① main.py を開く
② 右上の ▶ Run をクリック
③ 下部のターミナルに結果が表示されます
Hello, Python!
これでワンクリック実行が完了です。
仮想環境を使っている場合
VS Code は .venv を自動で検出しますが、もし別の Python が選ばれている場合は次の手順で切り替えられます。
① VS Code 左下の「Python 3.x.x」部分をクリック
② .venv/bin/python を選択
これで、VS Code の実行ボタンも仮想環境の Python を使うようになります。
プロジェクト単位でPythonのバージョンを変更（上級者向け）
複数のプロジェクトを扱う場合、プロジェクトごとに異なる Python バージョンを使い分けたいことがあります。pyenv には、そのためのローカル設定機能が用意されています。
プロジェクトごとにバージョンを変えたい場合、以下コマンドを実行します。
cd ~/projects/myapp
pyenv local 3.12.5
すると、ディレクトリに .python-version というファイルができて、ここだけ Python バージョンが固定されます。
仮想環境（venv）でライブラリも分ける（上級者向け）
プロジェクトごとに異なるライブラリ構成を使いたい場合、仮想環境（venv） を使うと安全かつ確実に環境を分離できます。Python 標準機能であるため、別途インストールする必要がなく、覚えておくと便利です。
① 以下のコマンドを実行し、 仮想環境を作成します。
cd ~/projects/myapp
python -m venv .venv
② 以下のコマンドを実行し、 仮想環境を有効化します。
# 有効化
source .venv/bin/activate
③ 以下のコマンドを実行し、バージョン・パスを確認します。
python --version
which python
④ 仮想環境を有効にした状態で pip install すると、そのプロジェクト専用にライブラリが入ります。
⑤ 仮想環境を無効化する場合は、以下のコマンドを実行しします。
deactivate
関連コンテンツ
コメント