MacでPythonを使おうとしたとき、次のようなエラーが出ることがあります。

zsh: command not found: python3

Pythonをインストールしたつもりなのに実行できないと、
「なぜ？」と戸惑ってしまいますよね。

このエラーは、Pythonが存在しないのではなく、見つけられていないだけ
というケースがほとんどです。

この記事でわかること

• command not found: python3 が出る主な原因
• Mac特有のPATHとPythonの関係
• 安全な確認・対処手順
• 今後同じエラーを防ぐ考え方

結論：原因はほぼこの4つ

先に結論です。
このエラーの原因は、ほぼ以下に集約されます。

1. Pythonがインストールされていない
2. PATHが通っていない
3. system PythonとHomebrew Pythonの混在
4. シェル設定（zsh）が反映されていない

順番に確認していきましょう。

原因① Pythonがインストールされていない

最も基本的な原因です。

確認方法

python --version
python3 --version

どちらも command not found になる場合、
Pythonが未インストールの可能性があります。

対処法（Mac）

Homebrewを使ってインストールします。

brew install python

原因② PATHが通っていない

Pythonは存在していても、
PATHに登録されていない と実行できません。

確認方法

which python3

何も表示されない場合、PATHが通っていません。

よくあるPythonの場所

• /opt/homebrew/bin/python3（Apple Silicon）
• /usr/local/bin/python3（Intel）

原因③ system PythonとHomebrew Pythonの混在

Macには最初から system Python が入っています。

system PythonはPATHに含まれないことがあり、
Homebrewで入れたPythonと混在すると混乱が起きます。

確認方法

which python3

/usr/bin/python3 が表示される場合は注意が必要です。

原因④ シェル設定が反映されていない

Pythonをインストールしても、
ターミナルを再起動していないとPATHが反映されません。

確認・対処

echo $SHELL

zshの場合は以下を確認します。

~/.zshrc

必要であれば、PATHを追記します。

export PATH="/opt/homebrew/bin:$PATH"

設定後は必ず反映します。

source ~/.zshrc

よくあるNG対応

• sudo で無理やり実行する
• system Pythonを削除しようとする
• PATHを理解せずにコマンドを追加する

これらはトラブルの原因になります。

今後同じエラーを防ぐために

• Pythonは Homebrew版を使う
• which python3 で場所を確認する
• PATHを意識する

この3点を押さえておけば、
command not found 系のエラーは大きく減らせます。

まとめ

command not found: python3 が出る原因は、

• Python未インストール
• PATH未設定
• Python環境の混在
• シェル設定未反映

のいずれかです。

落ち着いて順番に確認すれば、
必ず解決できます。