
pythonとpython3、pipとpip3。結局どれを打てばいいのか
※この記事にはアフィリエイトリンク(PR)を含みます。
ネットのチュートリアル通りにターミナルへpython sample.pyと打ち込んだら、command not found: pythonと言われて先に進めなくなった。あるいは逆に、pythonは通るのにpip installしたはずのライブラリがModuleNotFoundErrorになる。Excel VBAからPythonに乗り換えたばかりの人が、コードを書く前の「起動」の段階でつまずくのは実はよくあることです。
原因はほぼ一つで、あなたのパソコンにはpythonという名前のコマンドとpython3という名前のコマンドが別物として存在している(か、片方しか存在しない)ことにあります。同じことがpipとpip3にも言えます。
なぜこうなるか
Pythonには過去、2系(Python 2)と3系(Python 3)という互換性のない2つの系統が長く並存していた時期があります。2020年にPython 2は公式サポートが終了しましたが、その名残がコマンド名の慣習に残っています。
古い慣習が残る環境では、pythonはPython 2を指し、python3と打たないとPython 3が起動しないことがあります。
Python 2のサポート終了後に整備された比較的新しいLinux環境では、pythonというコマンド自体が用意されておらず、python3しか使えないことが多いです。
macOSは、Xcodeのコマンドラインツールなどを通じてpython3は使えても、python(バージョンなし)は入っていないことが多いです。
Windows向けのインストーラーからPythonを入れた場合は、pythonコマンドで起動できることが多く、加えてpyというランチャーコマンドが使えることもあります。一方でpython3という名前のコマンドは用意されないことがあります。
要するに、「pythonとpython3のどちらが使えるか」「pipとpip3のどちらが使えるか」は、OSの種類やPythonのインストール方法によって変わり、一律の正解がありません。これは仕様のばらつきであって、あなたの設定ミスとは限らない点を押さえておくと安心です。
pipとpip3についても同じ構造です。pipはインストールされているPythonに対応するパッケージ管理コマンドで、複数バージョンのPythonが共存する環境ではpipがどちらのPythonに紐づいているか分かりにくく、意図しない方にpip installしてしまうことがあります。
実際に確認すると、次のように出力が一致していれば、そのpython(またはpython3)とpip(またはpip3)は同じ環境を指しています。
$ python3 --version
Python 3.11.15
$ python3 -m pip --version
pip 24.0 from /usr/lib/python3/dist-packages/pip (python 3.11)パソコンの中に複数のPythonが同居しているケースも珍しくありません。Windowsの公式インストーラーで入れたPythonに加えて、Anacondaや、Microsoft Storeで入れたPythonが同時に存在していることもあります。macOSでも、システムに元から入っているPythonと、Homebrewで入れたPythonが両方存在することがあります。この状態でpython3と打つと、どちらが起動するかはPATH(コマンドを探す順番の設定)次第になり、「さっきpip installしたのに、今開いているエディタから実行するとModuleNotFoundErrorになる」という食い違いが起きやすくなります(この現象自体はPY02で詳しく扱います)。
いま実際にどの実体が使われているかを確認したいときは、which(Windowsならwhere)でコマンドの場所を調べます。
$ which python3
/usr/bin/python3
$ python3 -c "import sys; print(sys.prefix)"
/usrsys.prefixは、そのPythonがどのディレクトリを起点にインストールされているかを表す値で、whichで出てきたパスと近い場所を指していれば、想定通りのPythonが起動できていると判断できます。複数のPythonが混在して挙動が読めなくなってきたら、pyenv(Linux/macOS向け)のようなバージョン切り替えツールの利用も検討候補になりますが、まずは今使っているPythonがどれかをwhichと--versionで特定できるようになることが先決です。
直し方
迷ったときにまず打つべきコマンドは次の2つです。
python3 --version
python --versionどちらか一方でもPython 3.x.xと表示されれば、そのコマンド名を以後使い続けます。両方とも動くが表示されるバージョンが違う、という場合(3系と2系が両方入っている等)は、python3の方を優先してください。3系だけを対象にした記事や教材が大半なので、python3と明示しておくと事故が減ります。
pipについても同様に確認しますが、もっと確実な方法があります。それはpip単体ではなく、python3 -m pipという形でPythonからpipを呼び出すことです。
python3 -m pip install requestsこう書くと、「今使っているpython3に対応するpip」が確実に使われるため、pipコマンドがどのPythonに紐づいているか分からず困る、という事態を避けられます。複数のPython環境を行き来するようになったら、単独のpipよりpython3 -m pipを使う癖をつけておくと、後述の仮想環境(PY02で扱います)でも迷いにくくなります。
VS CodeなどのエディタでPythonファイルを実行している場合は、コマンドラインとは別に「エディタがどのPythonを使うか」という設定が存在します。VS Codeでは画面右下や、コマンドパレットから「Python: Select Interpreter」を選ぶことで、実行に使うPythonを明示的に指定できます。ターミナルでpython3 -m pip installしたのに、エディタの実行ボタンではModuleNotFoundErrorになる場合、ターミナルとエディタが別のPythonを見ている可能性が高いので、この設定を確認してください。
Windowsでpython3が見つからない場合は、py -3という書き方が使えることもあります。
py -3 --version
py -3 -m pip install requestsこれは複数バージョンのPythonをまとめて管理するランチャーで、Windows版のPython公式インストーラーに同梱されていることが多いコマンドです。
よくある誤解
「python3と打つのが正式で、pythonは古い書き方」という理解は半分正しく半分誤解です。正しくは、「pythonという名前が指す実体が環境ごとに違うので、3系であることを明示できるpython3の方が事故が少ない」というだけであり、pythonコマンドがPython 3を指すように設定されている環境でpythonと打つこと自体が間違いというわけではありません。実際、Windowsの公式インストーラーではpythonコマンドでPython 3が起動することが多く、その環境ではpythonと打っても何の問題もありません。大事なのは、自分の環境でどちらが何を指しているかを--versionで確認する習慣であって、どちらか一方を暗記することではありません。
もう一つよくある誤解が、「pip installは一度やればパソコン全体のどのPythonからでも使えるようになる」というものです。実際にはpipはある特定のPython環境に紐づいており、そのPythonの中にある「サードパーティ製ライブラリの置き場所」にファイルを追加しているに過ぎません。別のPython(別バージョンや、後述する仮想環境)から見れば、そこには何も入っていない状態に見えます。pip installした直後は動くのに、エディタやIDEの実行ボタンを押すとModuleNotFoundErrorになる、という現象の多くは、コマンドラインのpipとエディタが呼び出しているPythonが実は別物である、というケースです。
最後に、確認の手順を整理しておきます。
1. python3 --versionを打ち、Python 3.x.xと表示されるか確認する
2. 表示されなければpython --versionを試す
3. どちらもPython 3を指していれば、以後はそのコマンド名で統一する
4. ライブラリを入れるときは、単独のpipではなくpython3 -m pip install ライブラリ名(または動作確認できた方のコマンド名)で統一する
5. エディタから実行してエラーになる場合は、ターミナルとエディタで使われているPythonが同じかを、エディタ側のインタープリタ設定で確認する
この5つを押さえておけば、「どっちを打てばいいか分からない」状態からはひとまず抜け出せます。
まとめ
python/python3、pip/pip3のどちらを使うべきかに唯一の正解はなく、OSやインストール方法によって変わります。迷ったら--versionでバージョンを確認し、Python 3系であることが確認できたコマンドを使う。pipに関しては単独で打つよりpython3 -m pipの形にしておくと、今使っているPythonとのズレを防げます。この後PY02で扱う仮想環境の話も、根っこは同じ「今どのPythonを使っているか」を意識する習慣につながっています。
Pythonをもう少し学ぶなら
Amazonの検索結果へのリンクです。
コマンドラインの入門書:ターミナル操作の基本
Amazonのアソシエイトとして、ずっちーは適格販売により収入を得ています。