pip

pip 24+

pip パッケージ インストーラー CLI のクイック リファレンス:パッケージのインストール / アンインストール / 確認、仮想環境、requirements ファイル、構成、インデックス管理 — よく使うオプションと実用例をまとめました。

37 コマンド

ヘルプ

pip --version

pip バージョンとそれが指す Python インタープリターを表示します。

pip --version
pip --help

すべての pip サブコマンドを一覧表示します。

pip --help
pip <subcommand> --help

1 つの pip サブコマンドのすべてのフラグを表示します。

pip install --help | head -60

自身

python -m pip --version

pip を Python モジュールとして実行します — 複数の Python インタープリターがあるシステムでは直接 `pip` より推奨されます。

python -m pip --version
python -m pip install --upgrade pip

pip を最新バージョンにアップグレードします。pip がない venv にブートストラップするには `python -m ensurepip` と組み合わせます。

python -m pip install --upgrade pip
python -m ensurepip --upgrade

pip を含まない virtualenv に pip をブートストラップします(PEP 453)。

--upgrade; --default-pip

python -m ensurepip --upgrade

インストール

pip install <pkg>

既定のインデックス(PyPI)から `<pkg>` の最新バージョンをインストールします。

<pkg>; -r <req.txt>; -e <path>; -U; --upgrade-strategy only-if-needed|eager; --force-reinstall; --no-deps; --pre プレリリースを含める; --dry-run; --quiet

pip install requests
pip install '<pkg>>=<ver>'

バージョン指定子(PEP 440)でインストールします。`>=`、`==`、`<`、`~=`、`!=`、`===` を使用します。

pip install 'django>=4.2,<5'
pip install -r requirements.txt

requirements ファイルにリストされたすべてのパッケージをインストールします(1 行に 1 つの指定子、`# コメント` 許可)。

-r <file>; -c <constraints>; --no-deps; --require-hashes

pip install -r requirements.txt
pip install -e <path>

プロジェクトを editable / 開発モードでインストールします — `src/` が site-packages にシンボリック リンクされ、編集がライブで反映されます。

-e .; -e .[dev]; --no-deps

pip install -e .
pip install '.[dev]'

`pyproject.toml` で宣言されたオプションの extras を含む現在のプロジェクトをインストールします。

pip install '.[dev,docs]'
pip install git+https://github.com/<user>/<repo>.git

Git リポジトリから直接インストールします(任意の ref: branch、tag、commit)。

git+https://...; git+ssh://...; @branch; @tag; @commit

pip install 'git+https://github.com/requests/requests.git@main'
pip install <pkg> --index-url <url>

別のインデックスからインストールします — 企業 PyPI ミラー、JFrog Artifactory、AWS CodeArtifact など。

pip install <pkg> --index-url https://pypi.org/simple
pip install <pkg> --extra-index-url <url>

既定のインデックスに加えて追加のインデックスを検索します。リモート フェッチを完全に禁止するには `--no-index` を使用します。

pip install <pkg> --extra-index-url https://my-mirror/simple
pip install --user <pkg>

システム Python の代わりにユーザーの site-packages(`~/.local/`)にインストールします。

--user; --target <dir>

pip install --user pipx
pip install --dry-run <pkg>

実際にインストールせずに pip が何をインストールするかを表示します — CI プレビューに便利です。

--dry-run; --quiet; --report <file>

pip install --dry-run -r requirements.txt

確認

pip list

インストール済みパッケージを一覧表示します(Name / Version / Location 列)。

--format columns|freeze|json; --outdated; --uptodate; --user; --local; --pre; --not-required; --exclude; --include-editable

pip list --format=freeze > freeze.txt
pip list --outdated

新しいバージョンが利用可能なインストール済みパッケージを一覧表示します。

--outdated; --format columns|freeze|json

pip list --outdated --format=columns
pip show <pkg>

単一のインストール済みパッケージのメタデータを表示します:version、location、requires、required-by、summary。

-f すべてのファイルを表示; --files 同じ; <pkg>...

pip show -f requests
pip check

インストール済みパッケージが互換性のある依存関係を持つことを検証します — 壊れた依存関係競合を表面化します。

pip check
pip freeze

インストール済みパッケージを `pkg==ver` 形式で出力します(ソート済み、extras なし) — 正規の requirements.txt ソース。

--local; --user; --all; --exclude; --requirement <file>

pip freeze > requirements.lock

アンインストール

pip uninstall <pkg>

パッケージをアンインストールします。確認プロンプトをスキップするには `-y` を渡します。

<pkg>...; -y; -r <file> リストされたすべてのパッケージをアンインストール; --dry-run

pip uninstall -y requests
pip uninstall -r requirements.txt -y

requirements ファイルにリストされたすべてのパッケージをアンインストールします。

pip uninstall -r requirements.txt -y

インデックス

pip download <pkg>

wheel / sdist をディレクトリにダウンロードしますが、インストールはしません。エアギャップ転送に便利です。

-d <dir>; --no-deps; --no-binary :all:; --dest <dir>; --platform

pip download requests -d ./wheels
pip search <query>

名前 / 要約で PyPI のパッケージを検索します(現在 PyPI で無効; 代わりに Web UI を使用してください)。

pip search 'fastapi'
pip wheel <pkg>

プロジェクトとその依存関係の wheel を出力ディレクトリにビルドします。

-w <dir>; --no-deps; --no-binary :all:; --no-build-isolation

pip wheel . -w ./wheels
pip cache dir

ダウンロードされたファイルのキャッシュに pip が使用するディレクトリを表示します。

pip cache dir
pip cache purge

pip のダウンロード キャッシュをクリアします。破損した wheel ファイルを修正するときに便利です。

purge; list; info; remove <pattern>; --no-autoremove

pip cache purge
pip config list

アクティブな構成(環境変数 + site / global / user スコープの INI ファイル)を出力します。

list; edit; get <name>; set <name> <value>; unset <name>; --global; --user; --site

pip config list
pip config set global.index-url <url>

設定をアクティブな構成ファイルに永続化します。

--global; --user; --site; --editor; <name> <value>

pip config set global.index-url https://my-mirror/simple

検査

pip inspect

インストール済みパッケージのすべての依存関係、ファイル、メタデータ レコードを JSON としてダンプします(Dependabot などによって使用されます)。

pip inspect > installed.json

ハッシュ

pip install --require-hashes -r requirements.txt

ハッシュ固定の requirements でインストールします — pip はハッシュが一致しないものを拒否します(再現可能、改ざん防止)。

pip install --require-hashes -r requirements.txt
pip hash <file>

`--require-hashes` requirements で使用するためのファイルの SHA-256(既定)ハッシュを計算します。

<file>; --algorithm sha256|sha384|sha512

pip hash ./mypkg-1.0-py3-none-any.whl

VCS

pip install git+ssh://[email protected]/<user>/<repo>@<ref>

SSH 経由でインストールします(2FA 背後のプライベート パッケージに便利)。

@<branch>; @<tag>; @<commit>

pip install git+ssh://[email protected]/me/[email protected]

Venv 統合

python -m venv .venv

仮想環境を作成します(virtualenv の Python 標準ライブラリ代替)。アクティブ化されると pip は自動的に venv にインストールします。

.venv; --system-site-packages; --prompt <name>; --without-pip; --upgrade-deps

python -m venv .venv && source .venv/bin/activate

その他

pip debug --verbose

pip バージョン、サポートされているタグ(`cp311-cp311-manylinux_2_28_x86_64`)、pip がインストールできる Python バージョンを表示します。

--verbose

pip debug --verbose | head -40
pip install --upgrade pip setuptools wheel

venv 内のビルド ツールチェーンをアップグレードします — ソース ディストリビューションが新しい setuptools を必要とするときに必要です。

pip install --upgrade pip setuptools wheel

関連コマンド速查

pip について

pip は標準の Python パッケージ マネージャーで、再帰的アクロニム「pip installs packages」です。2008 年に Ian Bicking によって元々作成され、Python 2.7.9 / 3.4 で Python 標準ライブラリにデフォルト インストーラーとして採用されました。pip は PyPI(Python Package Index)と互換性のある PEP 503 リポジトリから Python パッケージをインストールします。現在の安定版は pip 24+(pip 25.x はレガシー リゾルバー警告を除去)です。pip は wheel(.whl)、ソース ディストリビューション(.tar.gz)、VCS URL(`git+https://...`)、ローカル editable インストール(`pip install -e .`)をサポートします。ほとんどのワークフローでは、uv / Poetry / Hatch がプロジェクト管理用の pip に取って代わりましたが、pip は普遍的なフォールバックのままです — ほとんどすべての Python ツールのドキュメントは `pip install <pkg>` を前提としています。pip は MIT ライセンス、Python Packaging Authority(PyPA)下で配布されています。pip はあなたのコードをアップロードしません; 構成されたインデックスからのみフェッチします。

チートシート バージョン 1.0.0