MacでPythonを使おうとして、
次のような表示が出て困ったことはありませんか。
zsh: command not found: python
Pythonをインストールしたつもりなのに、
pythonコマンドが使えないpython3は動く- そもそも何が違うのか分からない
と混乱しやすいポイントです。
この記事では、
Macで python コマンドが見つからない(command not found)原因と対処法を、
初心者向けに整理して解説します。
※ 本記事は Mac環境(python3)を前提 に説明します。
この記事でわかること
command not foundが表示される理由- Macで
pythonが使えない主な原因 pythonとpython3の考え方- 確認すべき基本コマンド
command not found とは何か
command not found
は、
入力したコマンドをMacが見つけられない状態を意味します。
つまり、
- Pythonがインストールされていない
- もしくは、存在しているが認識されていない
のどちらかです。
原因① Macでは python コマンドが用意されていない
現在のmacOSでは、python コマンドが最初から使えないケースが多いです。
その代わりに、
次のコマンドが用意されています。
python3
確認してみてください。
python3 --version
これでバージョンが表示される場合、
Python自体は正しくインストールされています。
👉 エラーではなく、仕様による違いです。
原因② python と python3 の違いを誤解している
Macでは、
python→ 存在しない、または無効python3→ 正式に使うコマンド
という状態が一般的です。
そのため、
python main.py
はエラーになり、
python3 main.py
で正常に動く、というケースがよくあります。
Macでは python3 を使う前提 で問題ありません。
原因③ PATHが通っていない
Pythonがインストールされていても、
PATHが通っていないとコマンドが見つかりません。
まず、Pythonの場所を確認します。
which python3
例:
/usr/bin/python3
このように表示されれば、
Pythonは正しく認識されています。
何も表示されない場合は、
PATH設定に問題がある可能性があります。
原因④ VS Codeとターミナルで環境が違う
VS Codeを使っている場合、
- VS Code上のPython
- macOSターミナルのPython
が異なることがあります。
VS Codeの下部(ステータスバー)に表示されている
Pythonバージョンが、
意図したものになっているか確認してください。
無理に python コマンドを作る必要はあるか?
結論として、
無理に python コマンドを使えるようにする必要はありません。
Macでは、
python3
pip3
を使うのが標準的です。
python を使えるように設定する方法もありますが、
初心者の段階では 混乱の元 になるためおすすめしません。
まず確認すべきチェックリスト
command not found が出たら、
次の順番で確認してください。
python3 --versionは動くかwhich python3でパスは表示されるか- コマンドを
python3にしているか - VS Codeとターミナルの環境は一致しているか
これでほとんどのケースは解決します。
まとめ
Macで python コマンドが見つからない場合、
多くは次の理由によるものです。
- Macでは
pythonが使えない仕様になっている python3を使う必要がある- PATHが通っていない
- 実行環境がズレている
エラーではなく、
Mac特有の仕様による混乱であるケースが大半です。
落ち着いて確認すれば、
すぐに解決できます。
コメントを残す