MENU

Pythonのpipとパッケージのインストール方法を初心者向けに解説

※写真はイメージです。実物とは異なる場合があります。

  • URLをコピーしました!

Pythonを学び始めると、必ずと言っていいほど耳にするのが「ライブラリ」や「パッケージ」という言葉です。Pythonの素晴らしいところは、世界中の開発者が作った便利な機能(ライブラリ)を、自分のプログラムに簡単に取り入れて使える点にあります。

しかし、初心者の方にとって「どうやってその便利な機能を自分のパソコンに導入すればいいのか」は大きな壁になりがちです。そこで重要になるのが、Pythonの標準的なパッケージ管理ツールである「pip」です。

この記事では、pipを使ってパッケージをインストールする方法から、日々の管理に欠かせない操作まで、かみ砕いて解説します。

目次

pipとは?パッケージ管理の仕組みを理解しよう

まず、pipが一体何なのかについてお話しします。pip(pip The Python Package Installer)は、一言でいえば「Pythonライブラリのインストーラー」です。

Pythonには、最初から組み込まれている「標準ライブラリ」というものがありますが、それだけではカバーできない高度な機能(例えばPDFの作成や高度なデータ分析など)を補うために、「サードパーティライブラリ」という外部のライブラリを利用します。

これらのサードパーティライブラリは、「PyPI(Python Package Index)」というコミュニティ運営の巨大な倉庫(レポジトリ)に保管されています。pipはこのPyPIから、必要なライブラリを探し出し、自分の環境に合ったバージョンをダウンロードしてインストールしてくれる心強いツールなのです。

pipが使えるか確認する方法

最近のPython(Python 3.4以降など)をインストールしていれば、基本的にpipは最初から同梱されています。まずは、自分のパソコンでpipが正しく動作するか確認してみましょう。

Windowsの方は「コマンドプロンプト」(検索窓に「cmd」と入力して起動する黒い画面)を開き、以下のコマンドを入力してEnterキーを押してください。

“`bash pip –version “`

もし、これでバージョン番号が表示されれば準備完了です。しかし、「コマンドが見つかりません」といったエラーが出る場合があります。特にWindowsのデフォルトインストール状態では、PATH(パス)が通っていないために直接 `pip` と打っても実行できないことがあります。

その場合は、以下のようにPython経由で呼び出す方法を試してみてください。

“`bash python -m pip –version “`

これで動作する場合、今後は `pip` の代わりに `python -m pip` を使うことで確実に操作が可能です。また、DebianやUbuntuなどのLinux環境では、標準のPythonにpipが含まれていないことがあり、その場合は `apt` コマンドで `python3-pip` パッケージをインストールする必要があります。

パッケージの基本インストール手順

それでは、実際にパッケージをインストールしてみましょう。

最新バージョンをインストールする

最も基本的なコマンドは以下の通りです。

“`bash pip install パッケージ名 “`

例えば、PDF作成に便利な `PyPDF2` というライブラリをインストールしたい場合は、次のように入力します。

“`bash pip install PyPDF2 “`

これを実行すると、pipがPyPIから最新の `PyPDF2` を探し出し、自動的にダウンロードしてインストールしてくれます。もし、そのライブラリが動作するために別のライブラリ(依存パッケージ)が必要な場合、pipはそれらも同時にインストールしてくれるため、ユーザーが一つひとつ手動で入れる手間はありません。

インストール中に「.whl」という拡張子が画面に表示されることがありますが、これは「Wheel」と呼ばれるビルド済みのパッケージ形式です。環境に合わせて最適化された状態で提供されているため、スムーズにインストールが進みます。

インストール済みか確認する

すでにインストールされているライブラリがあるか確認したいときは、以下のコマンドを使います。

“`bash pip list “`

これを実行すると、現在インストールされているすべてのパッケージとそのバージョンがリスト形式で表示されます。また、特定のパッケージについて詳しく知りたい場合は `pip show パッケージ名` を使うと、依存関係などの詳細情報を確認できます。

不要なパッケージを削除する

使わなくなったライブラリを削除したいときは、`uninstall` コマンドを使用します。

“`bash pip uninstall パッケージ名 “`

実行すると、本当に削除してよいか確認されるので、指示に従って進めてください。

応用的なパッケージ管理テクニック

基本操作に慣れてきたら、より実践的な管理方法について学びましょう。ここからは、開発現場でもよく使われる手法を紹介します。

バージョンを指定してインストールする

最新バージョンが常に正解とは限りません。特定のバージョンでしか動作しないプログラムを動かしたい場合は、バージョンを指定してインストールできます。

“`bash pip install パッケージ名==バージョン番号 “`

このように記述することで、意図しないアップデートによるエラーを防ぐことができます。

requirements.txtによる一括管理

複数のライブラリを使用するプロジェクトでは、一つひとつ `pip install` するのは大変です。そこで利用されるのが `requirements.txt` というファイルです。

このファイルには、プロジェクトで使用するライブラリ名とバージョンを一行ずつ記述しておきます。

requirements.txt の例: “`text PyPDF2==3.0.1 requests==2.31.0 “`

このファイルを用意すれば、以下のコマンド一発ですべてのライブラリをまとめてインストールすることが可能です。

“`bash pip install -r requirements.txt “`

逆に、現在の環境に入っているライブラリの一覧をファイルに保存したいときは、`pip freeze` コマンドを使います。

“`bash pip freeze > requirements.txt “`

こうすることで、他の人が同じ環境を再現したり、サーバーへ移行したりする際に非常に便利です。

【重要】グローバルインストールの罠と仮想環境

ここで、多くの初心者が陥りやすい「グローバルインストールの罠」について触れておきます。

通常、`pip install` を行うと、パソコン全体で共有される「グローバル環境」にライブラリがインストールされます。しかし、これにはリスクがあります。

例えば、「プロジェクトAではライブラリのバージョン1.0が必要」で、「プロジェクトBではバージョン2.0が必要」という場合、グローバル環境ではどちらか一方のバージョンしか持てません。一方を入れるともう一方が上書きされ、以前のプロジェクトが動かなくなるという衝突が起こります。

この問題を解決するのが「仮想環境(venvなど)」です。プロジェクトごとに独立した小さなPython環境を作ることで、ライブラリのバージョン衝突を完全に避けることができます。

仮想環境を作成して利用する際の流れは以下の通りです(代表的な例)。

  1. `python -m venv .venv` で仮想環境を作成する。
  2. 仮想環境を有効化(アクティベート)する。
  3. その状態で `pip install` を行う。

これにより、そのプロジェクト専用の領域にだけライブラリがインストールされるため、安全で再現可能な開発環境を構築できます。VSCodeなどのエディタを使用している場合は、設定からこの仮想環境のインタープリタを選択することで、正しくライブラリを認識させることができます。

まとめ:pipを使いこなして快適なPythonライフを

pipは、Pythonという言語の可能性を最大限に引き出すための不可欠なツールです。

  • `pip install` で世界中の便利な機能を導入できる。
  • `pip list` や `pip show` で現状を把握する。
  • `pip freeze` と `requirements.txt` で環境を記録・再現する。
  • 仮想環境 を活用して、プロジェクトごとの衝突を防ぐ。

これらの基本を押さえておけば、環境構築でつまずくことは格段に減るはずです。最初はコマンド操作に緊張するかもしれませんが、一つひとつのパッケージをインストールして、自分のプログラムに新しい機能が加わる快感をぜひ味わってください。

まずは、気になったライブラリを一つ、pipでインストールすることから始めてみましょう。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次