ITメモベース

Python・開発環境まわりの「つまずきポイント」を整理するITメモ


Macでpythonコマンドが見つからない(command not found)原因と対処法


MacでPythonを使おうとして、
次のような表示が出て困ったことはありませんか。

zsh: command not found: python

Pythonをインストールしたつもりなのに、

  • python コマンドが使えない
  • python3 は動く
  • そもそも何が違うのか分からない

と混乱しやすいポイントです。

この記事では、
Macで python コマンドが見つからない(command not found)原因と対処法を、
初心者向けに整理して解説します。

※ 本記事は Mac環境(python3)を前提 に説明します。

この記事でわかること

  • command not found が表示される理由
  • Macで python が使えない主な原因
  • pythonpython3 の考え方
  • 確認すべき基本コマンド

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 が出たら、
次の順番で確認してください。

  1. python3 --version は動くか
  2. which python3 でパスは表示されるか
  3. コマンドを python3 にしているか
  4. VS Codeとターミナルの環境は一致しているか

これでほとんどのケースは解決します。

まとめ

Macで python コマンドが見つからない場合、
多くは次の理由によるものです。

  • Macでは python が使えない仕様になっている
  • python3 を使う必要がある
  • PATHが通っていない
  • 実行環境がズレている

エラーではなく、
Mac特有の仕様による混乱であるケースが大半です。

落ち着いて確認すれば、
すぐに解決できます。


コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

PAGE TOP