メインコンテンツへスキップ
見出し画像

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)"
    /usr

    sys.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のアソシエイトとして、ずっちーは適格販売により収入を得ています。

     
     
    プログラマー・SE歴10年。PC・Excelのつまずきと、小さな店・ネット販売・イベント・ひとり仕事の「数が合わない」を、手順と記録表にして書いています。無料で最初の一手、有料で完全版。迷ったら固定表示のガイドへ。

    あなたへのおすすめ