Python
PR

pipの使い方|インストール・アップグレード・requirements.txtを実例で解説

pipの使い方|インストール・アップグレード・requirements.txtを実例で解説
hr
記事内に商品プロモーションを含む場合があります

pip install を打ったら「pip は認識されません」と表示された。インストールできたのに、プログラムを動かすと「そんなモジュールはない」と言われる。pip を使い始めたころは、こうしたつまずきがよく起こります。

この記事では、pip でパッケージ(ほかの人が作って公開している Python のライブラリ)をインストール・確認・アップグレード・アンインストールする方法と、requirements.txt で同じ環境を作り直す方法を、実際の実行結果つきで説明します。よく出るエラーの意味と直し方もまとめました。

実行結果は、Windows 11 の PowerShell 5.1、Python 3.12.6、pip 26.2.1 で、仮想環境の中で実際に実行して確かめたものです。パスは「…」で省略しています。バージョンは実行時期によって変わります。

この記事で扱うコマンド

やりたいことコマンド
パッケージを入れるpy -m pip install requests
バージョンを指定して入れるpy -m pip install “requests==2.31.0”
入っているパッケージの一覧を見るpy -m pip list
1 つのパッケージの詳しい情報を見るpy -m pip show requests
新しい版が出ているものを調べるpy -m pip list –outdated
新しい版にするpy -m pip install –upgrade requests
パッケージを消すpy -m pip uninstall requests
今の環境を requirements.txt に書き出すpy -m pip freeze
requirements.txt のとおりに入れるpy -m pip install -r requirements.txt

pip とは

pip(ピップ)は、Python のパッケージをインストールするための公式のツールです。パッケージの多くは PyPI(パイピーアイ、Python Package Index)という公開サイトに登録されていて、pip はそこからダウンロードしてインストールします。インストールするパッケージが別のパッケージを必要とする場合(これを「依存関係」といいます)は、それもまとめて入れてくれます。

pip は Python と一緒にインストールされます。Python 3.12 の公式インストーラーで入れた場合は、次のコマンドで pip のバージョンを確認できます。

py -m pip --version
pip 24.2 from C:\Users\…\Python312\Lib\site-packages\pip (python 3.12)

pip のバージョン(24.2)、どこの Python に付いている pip か(Python312 のフォルダー)、Python のバージョン(3.12)が分かります。pip を使う前に、この「どの Python の pip か」を確認するのが、トラブルを防ぐいちばんのコツです。

「py -m pip」と「pip」の違い

pip を動かす書き方は、主に 3 つあります。

書き方どの Python の pip が動くか
pip install …PATH(コマンドを探す場所の一覧)で最初に見つかった pip.exe(どの Python のものか分かりにくい)
python -m pip install …その python コマンドで動く Python の pip
py -m pip install …Windows の Python ランチャー(py)が選んだ Python の pip。仮想環境を有効にしていれば、その仮想環境の Python

-m pip は「pip モジュールを、この Python で実行する」という意味です。pip の公式ドキュメント(User Guide)でも、python -m pip は「指定した Python で pip を実行する」、py -m pip は「インストールされている最新の Python で pip を実行する」と説明されています。Python が複数入っているパソコンでは、pip だけだと「インストールした Python」と「プログラムを動かす Python」が食い違うことがあります。py -m pip や python -m pip の形なら、この食い違いが起こりにくくなります。

仮想環境を有効にしている場合は、pip も py -m pip も、その仮想環境の pip を指します(Python の公式ドキュメントにも、仮想環境が有効なら py ランチャーはその Python を使うと書かれており、実際にインストール先が仮想環境の中になることを確認しました)。

この記事では、Windows では py -m pip、Linux では python3 -m pip の形で書きます。

準備:仮想環境を作ってから使う

pip でパッケージを入れる前に、プロジェクト用の仮想環境(venv)を作るのがおすすめです。仮想環境は「このプロジェクト専用のパッケージ置き場」で、プロジェクトごとに別のバージョンを入れても、ほかのプロジェクトや Python 本体に影響しません。いらなくなったらフォルダーごと消せます。作り方・有効にする方法・エラーの直し方は「Python の仮想環境 venv の使い方」で詳しく説明しています。

プロジェクトのフォルダーで、次のコマンドを実行すると、.venv という名前の仮想環境ができます。

py -m venv .venv

PowerShell では次のコマンドで有効にします。有効になると、プロンプト(入力待ちの行)の先頭に (.venv) と表示されます。

.venv\Scripts\Activate.ps1

有効にしなくても、仮想環境の中の python.exe を直接指定すれば、確実にその仮想環境の pip を使えます。

.venv\Scripts\python.exe -m pip list

作ったばかりの仮想環境には pip しか入っていません(Python 3.12.6 で作った場合、pip は 24.2 でした)。このあとの例は、この仮想環境を有効にした状態で実行しています。

Package Version
------- -------
pip     24.2

パッケージをインストールする(pip install)

例として、HTTP 通信でよく使われる requests をインストールします。

py -m pip install requests
Collecting requests
  Using cached requests-2.34.2-py3-none-any.whl.metadata (4.8 kB)
Collecting charset_normalizer<4,>=2 (from requests)
  Using cached charset_normalizer-3.5.2-cp312-cp312-win_amd64.whl.metadata (47 kB)
(中略)
Installing collected packages: urllib3, idna, charset_normalizer, certifi, requests

Successfully installed certifi-2026.7.22 charset_normalizer-3.5.2 idna-3.20 requests-2.34.2 urllib3-2.8.0

Collecting はインストールするパッケージを集めている行で、(from requests) は「requests が必要としているので入れる」という意味です。Using cached は以前ダウンロードしたファイルを使ったという意味で、初めてなら Downloading になります。最後の Successfully installed が成功の表示で、requests 1 つを頼んだのに、依存関係の 4 つも一緒に入りました。

使えるかは、Python から読み込んで確かめます。

py -c "import requests; print(requests.__version__)"

2.34.2 と表示されれば、インストールした requests を Python から使えています。

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

教材やチームで使っているバージョンに合わせたいときは、パッケージ名のあとにバージョンを書きます。

書き方意味
“requests==2.31.0”ちょうど 2.31.0
“requests>=2.31”2.31 以上
“requests>=2.31,<3”2.31 以上、3 未満
py -m pip install "requests==2.31.0"

すでに別のバージョンが入っている場合は、古いものを自動で消して入れ替えます(実行結果の最後の部分)。

Installing collected packages: requests
  Attempting uninstall: requests
    Found existing installation: requests 2.34.2
    Uninstalling requests-2.34.2:
      Successfully uninstalled requests-2.34.2
Successfully installed requests-2.31.0

注意:バージョン指定は " で囲みましょう。> と < は、PowerShell・コマンド プロンプト・bash のどれでも「出力をファイルに書き込む/ファイルから読み込む」記号として扱われます。囲まずに py -m pip install requests>=2.31 と打つと、バージョン指定のない requests のインストールになり、pip の表示が =2.31 という名前のファイルに書き込まれてしまいます(PowerShell と Git Bash で確認)。pip の公式ドキュメントの例でも、バージョン指定は引用符で囲んでいます。

入っているパッケージを確認する

一覧を見る(pip list)

py -m pip list
Package            Version
------------------ ---------
certifi            2026.7.22
charset-normalizer 3.5.2
idna               3.20
pip                26.2.1
requests           2.34.2
urllib3            2.8.0

自分で入れた requests だけでなく、一緒に入った依存関係も並びます。

詳しい情報を見る(pip show)

py -m pip show requests
Name: requests
Version: 2.34.2
Summary: Python HTTP for Humans.
Home-page:
Author:
Author-email: Kenneth Reitz <me@kennethreitz.org>
License: Apache-2.0
Location: C:\Users\…\.venv\Lib\site-packages
Requires: certifi, charset_normalizer, idna, urllib3
Required-by: 

Location はインストール先です。「インストールしたのに import できない」ときは、ここが実行している Python(仮想環境)と同じかを確かめます。Requires はこのパッケージが必要とするもの、Required-by はこのパッケージを必要としているもの(空ならほかから使われていない)です。

新しい版があるものを調べる(pip list –outdated)

py -m pip list --outdated
Package  Version Latest Type
-------- ------- ------ -----
requests 2.31.0  2.34.2 wheel

requests 2.31.0 を入れた状態で実行した結果です。Version が今入っている版、Latest が PyPI にある最新版です。

アップグレードする(–upgrade)

入っているパッケージを最新版にするには、--upgrade(短く書くと -U)を付けます。--upgrade を付けずに py -m pip install requests を実行しても、すでに入っていれば Requirement already satisfied(もう入っています)と表示されるだけで、新しくはなりません。

py -m pip install --upgrade requests
Requirement already satisfied: requests in .\.venv\Lib\site-packages (2.31.0)
Collecting requests
(中略)
  Attempting uninstall: requests
    Found existing installation: requests 2.31.0
    Uninstalling requests-2.31.0:
      Successfully uninstalled requests-2.31.0
Successfully installed requests-2.34.2

2.31.0 が消され、2.34.2 が入りました。pip の公式ドキュメントによると、依存関係のパッケージは標準では必要なときだけアップグレードされます。

pip 自体をアップグレードする

pip が古いと、インストールのたびに最後に次のようなお知らせが出ます。

[notice] A new release of pip is available: 24.2 -> 26.2.1
[notice] To update, run: python.exe -m pip install --upgrade pip

お知らせのとおり、pip 自体は -m pip の形でアップグレードします。

py -m pip install --upgrade pip

Windows で pip install --upgrade pip(-m なし)と打つと、実行中の pip.exe 自身を書き換えられないため、次のエラーで止まりました。表示されたコマンドのとおり python.exe -m pip の形で実行し直せば成功します。

ERROR: To modify pip, please run the following command:
C:\Users\…\.venv\Scripts\python.exe -m pip install --upgrade pip

仮想環境を有効にしていない状態で実行すると、Python 本体の pip がアップグレードされます。まずは仮想環境の中の pip だけを新しくするのが安全です。

アンインストールする(pip uninstall)

py -m pip uninstall requests
Found existing installation: requests 2.34.2
Uninstalling requests-2.34.2:
  Would remove:
    c:\users\…\.venv\lib\site-packages\requests-2.34.2.dist-info\*
    c:\users\…\.venv\lib\site-packages\requests\*
Proceed (Y/n)?

消すファイルの一覧が表示され、Proceed (Y/n)?(続けますか?)と聞かれます。y を入力して Enter キーを押すと、Successfully uninstalled requests-2.34.2 と表示されて完了です。確認なしで消すには -y を付けます。

注意:pip uninstall は、指定したパッケージだけを消します。requests をアンインストールしたあとの pip list は次のとおりで、一緒に入った certifi・charset-normalizer・idna・urllib3 は残りました。

Package            Version
------------------ ---------
certifi            2026.7.22
charset-normalizer 3.5.2
idna               3.20
pip                26.2.1
urllib3            2.8.0

残ったものも消したい場合、ほかのパッケージが使っていないか(pip show の Required-by)を確かめてから 1 つずつ消すこともできますが、仮想環境を使っているなら、.venv フォルダーを削除して作り直すほうが簡単で確実です。

requirements.txt で同じ環境をそろえる

requirements.txt は、「このプロジェクトに必要なパッケージとバージョン」を 1 行に 1 つずつ書いたテキストファイルです。pip の公式ドキュメントでは「pip install に渡す引数を並べたファイル」と説明されています。これを Git でソースコードと一緒に管理しておけば、別のパソコンやチームのメンバーが同じパッケージをまとめて入れられます。仮想環境のフォルダー(.venv)自体は Git に入れず、requirements.txt から作り直すのが一般的です。

今の環境を書き出す(pip freeze)

py -m pip freeze
certifi==2026.7.22
charset-normalizer==3.5.2
idna==3.20
requests==2.34.2
urllib3==2.8.0

pip list と似ていますが、パッケージ名==バージョン の形(requirements.txt にそのまま使える形)で出力され、pip 自身は含まれません。これをファイルに保存します。PowerShell 5.1 では、次のように文字コードを指定して保存してください。

py -m pip freeze | Out-File -Encoding utf8 requirements.txt

Git Bash やコマンド プロンプトなら > で保存できます。

py -m pip freeze > requirements.txt

PowerShell 5.1 で py -m pip freeze > requirements.txt とすると、ファイルが UTF-16 という文字コードで保存されます(先頭が FF FE のバイトになることを確認しました)。pip 24.2 はこのファイルも読み込めましたが、Git では文字ではなくバイナリ(画像などと同じ扱い)と判断され、変更点を見ようとしても Binary files a/requirements.txt and b/requirements.txt differ としか表示されませんでした。文字コードについては「文字コードとは?」で詳しく説明しています。

requirements.txt から入れる(pip install -r)

別のパソコンでは、仮想環境を作って有効にしたあと、次のコマンドを実行します。

py -m pip install -r requirements.txt
Collecting certifi==2026.7.22 (from -r requirements.txt (line 1))
Collecting charset-normalizer==3.5.2 (from -r requirements.txt (line 2))
(中略)
Successfully installed certifi-2026.7.22 charset-normalizer-3.5.2 idna-3.20 requests-2.34.2 urllib3-2.8.0

ファイルの何行目から来たパッケージかが、(line 1) のように表示されます。なお、pip の公式ドキュメントには、ファイルに書いた順番どおりにインストールされるとは限らないと書かれています。

freeze で書き出すか、手で書くか

pip freeze の出力は、依存関係まで含めてすべてのバージョンを固定します。「いつ誰が入れても同じ結果になる」反面、自分で選んだパッケージ(requests)と、自動で入ったパッケージ(urllib3 など)の区別が付かなくなります。小さなプロジェクトでは、直接使うパッケージだけを手で書く方法もあります。# から始まる行はコメントです。

# HTTP 通信
requests>=2.31,<3

このファイルで pip install -r を実行すると、requests の 2.31 以上 3 未満の最新版(実行時点では 2.34.2)と、その依存関係が入りました。ファイルの中では >= を引用符で囲む必要はありません。

よくあるエラーと直し方

「’pip’ は認識されません」と表示される

pip.exe のあるフォルダーが PATH に入っていないときに出ます。英語表示の Windows では、PowerShell では次のように表示されました(コマンド プロンプトでは 'pip' is not recognized as an internal or external command…。日本語表示の Windows では「認識されません」という日本語のメッセージになります)。

pip : The term 'pip' is not recognized as the name of a cmdlet, function, script file, or operable program.

PATH を設定し直さなくても、py -m pip の形にすれば動きます。py ランチャーは Windows のフォルダー(この記事の環境では C:\Windows\py.exe)に入るため、PATH の設定にかかわらず使えることが多いからです。実際に、この記事を確かめたパソコンも pip が PATH に入っていない状態でしたが、py -m pip --version は動きました。仮想環境を有効にすれば、その中の pip.exe に PATH が通るので、pip とだけ打っても動くようになります。

インストールしたのに ModuleNotFoundError になる

「pip でインストールした Python」と「プログラムを動かしている Python」が違うのが、いちばん多い原因です。py -m pip show requests の Location(インストール先)と、py -c "import sys; print(sys.executable)" で表示される実行中の Python の場所を見比べてください。

仮想環境を有効にし忘れた、VS Code で別の Python(インタープリター)が選ばれている、といった場合に食い違います。プログラムを動かすのと同じ Python で -m pip install を実行し直せば解決します。

No matching distribution found

ERROR: Could not find a version that satisfies the requirement reqeusts-not-exist-xyz (from versions: none)
ERROR: No matching distribution found for reqeusts-not-exist-xyz

存在しない名前を指定したときの表示です。まずパッケージ名のつづりを確認しましょう。名前が正しくても、指定したバージョンがない場合や、使っている Python のバージョンに対応した版がない場合にも同じエラーになります。

注意:PyPI には誰でもパッケージを登録できるため、有名なパッケージに似た名前の不正なパッケージが見つかることがあります。つづりを間違えたまま、たまたまインストールできてしまうのがいちばん危険です。インストールする前に、パッケージ名を公式サイトや PyPI のページ(https://pypi.org/project/パッケージ名/)で確認しましょう。

error: externally-managed-environment(Linux)

Linux で、仮想環境を使わずに pip install を実行すると、次のエラーが出ることがあります。

error: externally-managed-environment

This environment is externally managed
(ここに OS ごとの案内文が入る)

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

これは PEP 668(Python の仕様を決める提案書の 1 つ。状態は Final=採用済み)で決められたしくみです。Linux の Python は OS 自体の部品としても使われているため、OS のパッケージ管理(apt など)で管理している Python に pip で勝手にパッケージを入れると、OS の動作を壊すおそれがあります。そこで、Python の標準ライブラリのフォルダーに EXTERNALLY-MANAGED というファイルを置いた OS では、pip は仮想環境の外へのインストールを断るようになっています。

上の表示は pip 26.2.1 のソースコードで文面を確かめたもので、Linux の実機では確かめていません。真ん中には OS が用意した案内文が入ります。

直し方は、仮想環境を作ってその中で pip を使うことです。PyPA(Python のパッケージ関連の仕様をまとめているグループ)の仕様でも、仮想環境の中ではこの制限はかからないと書かれています。

python3 -m venv .venv
source .venv/bin/activate
python -m pip install requests

コマンドとして使うアプリ(ツール)を入れたい場合は、アプリごとに仮想環境を自動で作る pipx も PEP 668 で紹介されています。

注意:エラー文にある --break-system-packages を付けると制限を無視して入れられますが、PEP 668 でも「危険であることが伝わる名前にすべき」とされているオプションです。OS が使っている Python のパッケージを上書きして、OS のツールが動かなくなるおそれがあります。sudo pip install と組み合わせるのは特に避けてください。

よくある質問

–user は付けたほうがいいですか?

--user は、Python 本体ではなく自分のユーザー用のフォルダーにインストールするオプションです(pip の公式ドキュメントによると、Windows では %APPDATA%\Python の下)。管理者権限なしで入れられますが、同じユーザーのすべてのプロジェクトに影響します。プロジェクトで使うパッケージは、--user ではなく仮想環境に入れるのがおすすめです。なお、仮想環境の中で --user を付けると ERROR: Can not perform a '--user' install. というエラーになりました。

まとめ

  • pip は py -m pip(Linux は python3 -m pip)の形で、どの Python の pip かをはっきりさせて使う
  • プロジェクトごとに仮想環境を作り、その中にインストールする
  • バージョン指定は "requests>=2.31" のように引用符で囲む
  • uninstall は依存関係を消さない
  • requirements.txt は PowerShell 5.1 では Out-File -Encoding utf8 で保存し、pip install -r で再現する

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました