Windowsエラー
 Computer >> コンピューター >  >> トラブルシューティング >> Windowsエラー

【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方

コマンドプロンプトからPythonパッケージをインストールしようとした際、「'pip' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません」というエラーが表示されるケースが少なくありません。多くのユーザーからは、Pythonをインストール済みでPATH変数への追加も確認しているにもかかわらず、この問題が発生すると報告されています。Windows 7、Windows 8、Windows 10のいずれでも発生が確認されており、特定のOSに限定された問題ではありません。

【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方

PiPとは?

PiPは「Pip Installs Packages」の再帰的な略称です。Pythonで書かれたソフトウェアパッケージをインストール・管理するためのパッケージ管理システムであり、多くのユーザーはPython Package Index(PyPI)に公開されているパッケージの導入や管理にPiPを活用しています。

なお、Python 2.7.9以降およびPython 3.4以降のバージョンには、PiPがデフォルトで同梱されています。

「pipが認識されない」エラーの主な原因

さまざまなユーザーレポートを調査し、実際に再現を試みた結果、このエラーが発生する主なシナリオとして以下の2点が判明しました。

  • PiPのインストール先がシステム変数に登録されていない – CMDウィンドウからPython関連のコマンドを実行するには、PiPのインストール先パスをPATH環境変数に追加する必要があります。インストーラーを使ってPythonを導入した場合は通常自動的に追加されますが、登録されていないケースもあります。
  • PATHへの追加方法に誤りがある – PATHを手動で編集する際、余分なスペースが入ったり、既存のパスとの間のセミコロン(;)が抜けたりすると、このエラーが発生します。

以下の対処法は、実際に効果があったと少なくとも1人のユーザーから報告されているものばかりです。上から順番に試し、ご自身の環境で問題が解決する方法を見つけてください。

方法1:PIPがPATH変数に登録されているか確認する

まずは現状を把握しましょう。PIPのインストール先がPATH変数に登録されているかどうかは、CMDで簡単なコマンドを実行するだけで確認できます。これにより、不要な作業を省き、効率よくトラブルシューティングを進められます。

注意:すでにPATH変数への登録状況が分かっている方は、次の方法に進んでください。

  1. Windowsキー + Rを押して「ファイル名を指定して実行」を開き、「cmd」と入力してEnterキーを押します。コマンドプロンプトが起動します。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  2. コマンドプロンプトにecho %PATH%と入力し、Enterキーを押します。PATH変数に登録されているすべての場所が一覧表示されます。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  3. 表示の中にC:\Python37\Scriptsのようなパス(Pythonのバージョンによって異なります)が見つかれば、インストール先はすでにPATH変数に登録されています。その場合は、次の方法をスキップして方法4に進んでください。

上記の確認でPiPのパスが見つからなかった場合は、方法2または方法3に進み、PATH環境変数にPIPを追加してください。

方法2:WindowsのGUIからPIPをPATH環境変数に追加する

方法1でPIPが環境変数に登録されていないことが判明し、Python自体はすでにインストール済みの場合は、手動でパスを追加します。以下の手順を完了すれば、コマンドプロンプトからPiPコマンドを実行できるようになります。

  1. Windowsキー + Rを押して「ファイル名を指定して実行」を開き、「sysdm.cpl」と入力してEnterキーを押します。「システムのプロパティ」画面が開きます。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  2. 詳細設定」タブを開き、「環境変数」ボタンをクリックします。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  3. 「システム環境変数」の一覧から「Path」を選択し、「編集...」ボタンをクリックします。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  4. 「編集」画面で「新規」をクリックし、PiPのインストール先パスを追加します。Python 3.4の場合、デフォルトの保存先はC:\Python34\Scriptsです。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  5. パスを追加したら、新しいCMDウィンドウを開き、PiPを使ってPythonパッケージをインストールしてみてください。「pipが認識されない」エラーは表示されなくなるはずです。

より手軽に環境変数へ追加したい場合は、次の方法3をご利用ください。

方法3:CMDからPIPをPATH環境変数に追加する

コマンドプロンプトから直接PATH環境変数を設定することもできます。GUI操作よりも手早く完了しますが、ターミナル操作に慣れていない方には少しハードルが高く感じられるかもしれません。

  1. Windowsキー + Rを押して「ファイル名を指定して実行」を開き、「cmd」と入力してEnterキーを押します。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  2. コマンドプロンプトで以下のコマンドを実行し、PIPのインストール先を環境変数に登録します。
    setx PATH “%PATH%;C:\Python37\Scripts”

    注意:このコマンド例ではPython 3.7のデフォルトの保存先を使用しています。別のバージョンを使っている場合やカスタムの場所にインストールした場合は、「;」以降のパスを適宜変更してください。

  3. 同じCMDウィンドウから、PiPを使うPythonパッケージのインストールを試し、成功するかどうかを確認します。まだエラーが表示される場合は、次の方法に進んでください。

方法4:PiPを環境変数に追加せずにPythonパッケージをインストールする

PATH環境変数にPiPを追加せずに、CMDから直接Pythonパッケージをインストールしたい場合は、いくつかのコマンドを使う方法があります。前述の方法で環境変数を設定してもエラーが解消しない場合にも有効です。

簡易的な方法

  1. Windowsキー + Rを押して「ファイル名を指定して実行」を開き、「cmd」と入力してEnterキーを押します。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  2. 以下のコマンドを入力します。[packagename]の部分は、インストールしたいパッケージ名に置き換えてください。
    python -m pip install [packagename]

詳細な方法

  1. Windowsキー + Rを押して「ファイル名を指定して実行」を開き、「cmd」と入力してEnterキーを押します。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  2. 以下のコマンドで、Pythonの.whlファイルが保存されているディレクトリへ移動します。
    cd C:\python installs

    注意:この例では「python installs」というフォルダにインストールパッケージが保存されている想定です。実際のwheelファイルの場所に合わせてパスを変更してください。

  3. 続いて、以下のコマンドでPiP経由でパッケージをインストールします。
    c:\python37\scripts\pip.exe install [package].whl

    注意:古いバージョンを使っている場合やカスタムの場所にインストールした場合は、Pythonのインストール先を実際のパスに変更してください。また、[package]もインストールしたいパッケージ名に置き換えます。

これらの方法でもCMDからのインストールができない場合は、最後の方法に進み、PiPが正しくインストールされているかを確認しましょう。

方法5:PythonのインストールにPiPが含まれているか確認する

Python環境全体を再インストールする前に、そもそもPiPがPythonのインストール時に除外されていないかを確認しましょう。一部のPythonインストーラーでは、デフォルト設定のままではPiPがインストールされないことがあります。

幸い、Pythonのインストールを「変更」することで、後からPiPを追加できます。手順は以下の通りです。

  1. Windowsキー + Rを押し、「appwiz.cpl」と入力してEnterキーを押します。「プログラムと機能」が開きます。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  2. 「プログラムと機能」の一覧からPythonを右クリックし、「変更」を選択します。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  3. セットアップ画面で「Modify(変更)」をクリックします。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  4. 「オプション機能」画面で「pip」にチェックを入れ、「次へ」をクリックします。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  5. 「インストール」ボタンを押して変更を適用します。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  6. 変更が完了したらCMDウィンドウを開き、PiPでパッケージをインストールできるか確認します。エラーが表示されなければ成功です。

方法6:実行ファイル形式のインストーラーでPythonを再インストールする

ここまでの方法で解決しない場合は、Pythonとそのコンポーネントを再インストールすることで、「pipが認識されない」エラーが解消する可能性が高いです。

最も簡単なのは、公式の実行ファイル形式インストーラーを使う方法です。正しく設定すれば、PiPも自動的にインストールされます。

  1. Windowsキー + Rを押し、「appwiz.cpl」と入力してEnterキーを押し、「プログラムと機能」を開きます。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  2. 一覧からPythonを探して右クリックし、「アンインストール」を選択します。画面の指示に従って削除したら、PCを再起動します。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  3. 再起動後、Python公式サイトにアクセスし、お使いのOSアーキテクチャ(32bit/64bit)に合った最新の実行ファイル形式インストーラーをダウンロードします。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  4. インストーラーを起動し、最初の画面で「Add Python to PATH」にチェックが入っていることを確認します。これにより、コマンドプロンプトからPythonコマンドを実行できるようになります。確認できたら「Customize installation(カスタマイズ インストール)」をクリックします。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  5. 「オプション機能」画面で「pip」にチェックが入っていることを確認し、「次へ」をクリックします。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  6. 保存先や詳細オプションはデフォルトのままにして、「Install(インストール)」をクリックします。【解決】「pip」が内部コマンドまたは外部コマンドとして認識されないエラーの直し方
  7. インストールが完了したら、自動的に再起動を求められない場合は、手動でPCを再起動します。
  8. 再起動後、CMDウィンドウからPythonパッケージをインストールし、問題が解決したかどうかを確認します。
  9. それでも「pipが認識されない」エラーが表示される場合は、CMDで以下のコマンドを実行してみてください。
    python -m ensurepip --default-pip

    注意:一部のPythonディストリビューション(特に3.6)では、PiPがデフォルトでインストールされないことがあります。このコマンドは、公式ドキュメントにも記載されている正式な対策のひとつです。

  1. Seagate外付けHDDのビープ音と認識されない問題を解決する6つの方法

    名前の通り、外付けハードディスクドライブ(外付けHDD)は、コンピューターの外部ポートに接続して使用するストレージデバイスです。PCのデータ保存領域を手軽に拡張できるため、大量のデータを扱う方には非常に便利なアイテムです。大容量データストレージソリューションで知られるSeagate(シーゲイト)の外付けHDDをお使いの方で、「ビープ音が鳴る」「PCに認識されない」といったトラブルに遭遇したことはありませんか?本記事では、この問題の原因と、誰でも試せる6つの解決方法を詳しく解説します。Seagate外付けHDDのビープ音・認識されない問題の直し方HDDからビープ音が鳴るのは正常な動作ではありませ

  2. 【解決策】Windows 11/10でUSB 3.0外付けドライブが認識されないときの対処法

    お使いのWindows PCがUSB 3.0の外付けハードディスクを認識してくれない――。エクスプローラーを開いても、接続したデバイスがどこにも表示されない……。そんな経験はありませんか?実はこれは多くのユーザーが遭遇するトラブルで、USB 3.0ポートに接続した外付けドライブがシステムに検出されないという症状として現れます。本記事では、この問題を解決するための効果的な対処法を厳選してご紹介します。ぜひ最後まで読んで、お使いの環境に合った解決策を見つけてください。USB 2.0とUSB 3.0の違いとは?USBデバイスは、私たちの日常生活に欠かせない存在となっています。USBメモリは、デバイス