Pythonのpipのエラーと解決方法を現役エンジニアが解説【初心者向け】

初心者向けにPythonのpipのエラーと解決方法について現役エンジニアが解説しています。pipはPythonのパッケージを管理するシステムです。pipでエラーが発生する場合はsetuptoolsやpipプログラム自体をアップデートしてみましょう。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

Pythonのpipのエラーと解決方法について解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事をまずご覧ください。

 

なお本記事は、TechAcademyのPythonオンライン講座の内容をもとにしています。

 

田島悠介

今回は、Pythonに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

Pythonのpipのエラーと解決方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

Pythonのパッケージ管理システムpipとは

pipとは、Pythonでプログラミングを行う際に利用する「パッケージ」と呼ばれるものを管理するシステムです。

パッケージとは、他の人が作ったプログラムの部品のようなものでライブラリとも呼ばれます。

Pythonには多くのパッケージがあり、それぞれのパッケージの組み合わせによってはうまく動作しなくなってしまう場合もあります。

pipを導入すると以下のようなことを行ってくれます。

  • パッケージのダウンロード:Python Package Indexというサイトからパッケージのダウンロードを行います
  • 他のパッケージとの互換性チェック:パッケージをインストールする前に他のパッケージとの互換性チェックを行い、必要に応じてアップデートも行ってくれます。これによりパッケージ導入による動作不具合を回避することができます
  • パッケージのインストール、アンインストール:pipがインストールされているパッケージリストを管理しているため、簡単なコマンドでパッケージのインストールとアンインストールが可能です。

なお、Pythonのパッケージ管理システムにはcondaというものも存在します。
併用すると動作不具合の原因になるため、どちらか一方に統一して利用しましょう。

  • anacondaでPythonをインストールした場合:condaを利用
  • それ以外(公式サイトなどから)Pythonをインストールした場合:pip(pipenv)を利用

 

pipの主なコマンド

pipの主なコマンドは以下の通りです。

バージョンの確認
 

pip -V

 
パッケージのインストール
 

pip install パッケージ名

 
パッケージのアンインストール
 

pip uninstall パッケージ名

 
パッケージを最新版に更新
 

pip install -U パッケージ名

 
インストール済パッケージの一覧を表示
 

pip list

 

[PR] Pythonで挫折しない学習方法を動画で公開中

pipのエラーと解決方法

pipでinstallを行った際、以下のようなエラーが発生する場合があります。
 

error: invalid command 'egg_info'
----------------------------------------
Command "python setup.py egg_info" failed with error code xxx

 
このような場合には、pipの補助ツールとしてインストールされている「setuptools」を最新版に更新しましょう。
 

pip install -U setuptools

 
同様に、pip自体のバージョンが古くてインストールがスムーズに進まない場合もあります。

他のパッケージと同様に、pip自体もアップデートできます。
 

pip install -U pip

 

監修してくれたメンター

太田和樹(おおたかずき)

ITベンチャー企業のPM兼エンジニア

普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。

開発実績:画像認識技術を活用した駐車場混雑状況把握(実証実験)、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント。

地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

オンラインのプログラミングスクールTechAcademyではPythonを使って機械学習の基礎を学ぶPythonオンライン講座を開催しています。

初心者向けの書籍を使って人工知能(AI)や機械学習について学ぶことができます。

現役エンジニアがパーソナルメンターとして受講生に1人ずつつき、マンツーマンのメンタリングで学習をサポートし、最短4週間で習得することが可能です。

また、現役エンジニアから学べる無料のプログラミング体験会も実施しているので、ぜひ参加してみてください。