Pipenv コマンドの基本使い方【コマンド一覧】

Posted at 2025-04-12

以下は、Pipenv の主なコマンドを一覧形式でまとめたものです。各コマンドは、Pipenv を使ってパッケージ管理と仮想環境の操作を行うための基本的なものとなっています。

pipenv install [package]
→ 指定したパッケージを仮想環境にインストールし、Pipfile に追加します。
※オプション例
- --dev … 開発用パッケージとしてインストール（[dev-packages] に追加）
- --python <version/path> … 特定の Python バージョンを用いて環境を作成
pipenv uninstall [package]
→ 指定したパッケージをアンインストールし、Pipfile および Pipfile.lock から削除します。
※オプション例
- --all … 仮想環境内のすべてのパッケージを削除（Pipfile はそのまま残る）
- --all-dev … 開発用パッケージのみを削除
pipenv lock
→ Pipfile の内容に基づいて Pipfile.lock を生成または更新します。
※※ロックファイルによる依存関係の決定論的（再現可能な）環境構築を実現
pipenv sync
→ 既にロックされた Pipfile.lock の内容に従い、仮想環境を正確に再現するために依存関係をインストールします。
※デプロイ時など、確実な環境再現が必要な際に有用
pipenv update [package]
→ 特定のパッケージ（または全パッケージ）の依存関係を、最新の解決版に更新します。
pipenv upgrade [package]
→ 環境内の特定パッケージのロック状態を更新します（更新したパッケージを環境に反映する）。

pipenv run
→ 仮想環境内で任意のコマンドを実行します。
例: pipenv run python や pipenv run pip freeze
pipenv shell
→ 仮想環境のシェルを起動します。アクティブな仮想環境内で操作を行いたい場合に使用します。
pipenv --venv
→ 現在使用している仮想環境のパスを表示します。
pipenv --rm
→ 対象プロジェクトの仮想環境を削除します。新たに環境を作り直す場合などに便利です。

pipenv graph
→ インストールされているパッケージの依存関係ツリーをグラフ形式で表示します。
依存関係の全体像を把握するのに役立ちます。
pipenv check
→ インストール済みパッケージに対して、セキュリティの脆弱性や PEP 508 の要求が満たされているかをチェックします。
pipenv scripts
→ Pipfile 内の [scripts] セクションで定義したスクリプト一覧を表示します。
※これにより、定義済みのコマンドショートカットを確認できます。

オプションの活用例
例えば、pipenv install --dev flask のようにすれば Flask を開発用の依存関係として追加できます。
また、pipenv install --python 3.9 とすることで、指定バージョンの Python を用いた仮想環境を作成します。
実行例
1. プロジェクトディレクトリで環境初期化
```
pipenv --python 3.9
```
2. パッケージのインストール
```
pipenv install requests
```
3. 仮想環境に入る
```
pipenv shell
```
4. 環境内で実行
```
pipenv run python -m pip freeze
```
5. 依存関係のグラフ表示
```
pipenv graph
```

これらのコマンドを組み合わせることで、Pipenv を利用した依存関係管理と仮想環境の操作が容易になり、プロジェクト固有の環境構築をシンプルかつ再現性のあるものにできます。