pipの使い方|インストール・アップグレード・requirements.txtを実例で解説
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で再現する
関連する記事・ツール
- Pythonの仮想環境venvの使い方|Windows・Linuxでの作成と有効化を解説
- .gitignoreの書き方と、無視されないときの確認方法・直し方を実行結果つきで解説
- 文字コードとは?UTF-8・Shift_JIS・EUC-JPの違いと文字化けの原因・直し方
- UTF-8とは?仕組み・バイト数・BOMの有無をわかりやすく解説
- 環境変数PATHとは?Windows・Linuxの確認・設定と「認識されません」の直し方
- Pythonのimportとif __name__ == “__main__”の意味を解説