MacでPythonを使っていると、

• python では動かない
• python3 にすると動く
• 逆に、どちらを使えばいいのか分からない

といった状況に遭遇することがあります。

これは Macにおける python と python3 の扱いの違い が原因で起こる、非常に多いトラブルです。

この記事では、
Macで python と python3 の違いが原因でプログラムが動かないときの原因と対処法を、初心者向けに分かりやすく解説します。

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

この記事でわかること

• Macで python と python3 が分かれている理由
• 現在どのPythonが使われているかの確認方法
• 動かない原因になりやすいパターン
• 正しい実行方法と考え方

Macでpythonとpython3が分かれている理由

Macでは、次の2つのPythonが存在することがあります。

• システムに関連するPython
• ユーザーが利用するPython（Python 3）

過去のmacOSでは、
python コマンドが Python 2 を指しているケースがありました。

その名残として、現在でも多くの環境で

• python
• python3

が 別のPythonを指す 状態になっています。

pythonとpython3の違いで起こりやすいトラブル

よくある例

• python test.py ではエラーになる
• python3 test.py では正常に動く
• pip install したのに import できない

これらは、

• インストールしているPython
• 実行しているPython

が 一致していない ことが原因です。

今使われているPythonを確認する方法

まずは、python と python3 がそれぞれ何を指しているかを確認します。

ターミナルで次を実行してください。

python --version

python3 --version

結果の見方

• python → Python 2.x またはエラー
• python3 → Python 3.x

となっている場合、
Python 3を使うなら python3 を使う必要があります。

正しい実行方法（基本）

MacでPython 3を使う場合、基本的には次のように実行します。

python3 ファイル名.py

例：

python3 test.py

初心者のうちは、

• python は使わない
• python3 を使う

と覚えておくのが安全です。

pythonで動かないときの考え方

もし次のような状況になった場合でも、

python test.py

でエラーが出ること自体は 異常ではありません。

Macでは、

• python が古いPythonを指している
• そもそも設定されていない

というケースが普通にあります。

そのため、

• 動かない → 環境がおかしい
  ではなく
• python3 を使えばよい

と考えるのが正解です。

pythonとpipの組み合わせにも注意

python と python3 の違いは、pip にも影響します。

• pip
• pip3

も、それぞれ 別のPythonに紐づいている 場合があります。

Python 3を使う場合は、

pip3 install ライブラリ名

を使うようにしてください。

まとめ

Macで python と python3 の違いが原因で動かない場合、
多くは次の点が原因です。

• python と python3 が別のPythonを指している
• 実行時に python を使っている
• Python 3用のライブラリを pip3 で入れていない

対処法としては、

• python3 を使って実行する
• pip3 を使ってライブラリを管理する

これだけで、多くのトラブルは解消できます。