2026.03.24

Python Pipenvの使い方｜インストールからパッケージ管理方法を解説

Python

Pythonの開発環境をvenvとpipで管理していて、プロジェクトごとの依存関係がうまく整理できなかったり、チームメンバーとの環境共有で手間を感じたことはありませんか？Pipenvは、こうした課題を解消するために作られたPythonのパッケージ管理ツールです。

この記事で学べること：

Pipenvの役割と導入するメリット
インストール方法とプロジェクトの作成手順
パッケージの追加・削除などの基本操作
スクリプト実行や環境変数管理などの応用的な使い方

Pipenvの基本を押さえておくと、Python開発で起きがちな「環境の不一致」や「依存関係の衝突」といった問題に自分で対処できるようになります。

Pipenvとは

Pipenvとは、Pythonの仮想環境作成とパッケージ管理を一元化するためのCLIツールです。従来はvenvで仮想環境を作り、pipでパッケージを管理するという2つの操作が必要でしたが、Pipenvではこれらを一つのワークフローに統合できます。

Pipenvが解決する主な課題は、プロジェクト間での依存関係の衝突です。プロジェクトごとに独立した仮想環境を作成し、必要なパッケージとバージョンをPipfileに記録します。さらにPipfile.lockで依存関係を厳密に固定するため、チームメンバー全員が同じ環境を再現できます。

Pipenvのインストール

まずはインストールして使ってみましょう。以下に、インストールするために必要な手順を簡単に説明します。

必要な環境

Pipenv をインストールする前に、Python が既にインストールされていることを確認してください。Pipenv は Python 3.7 以上で動作しますが、最新の機能を利用するためには、可能な限り最新バージョンの Python を使用することをお勧めします。

python -V

インストール方法

Pipenv は Python のパッケージマネージャである pip を通じて簡単にインストールできます。以下のコマンドをターミナルまたはコマンドプロンプトに入力してください。

pip install pipenv
# インストールされたかどうか、バージョンを確認
pipenv --version

このコマンドは、グローバルに Pipenv をインストールします。プロジェクトごとに異なるバージョンの Pipenv を使用したい場合は、Python の仮想環境を作成し、その環境内で Pipenv をインストールしてください。

Pipenv でのプロジェクト作成

Pipenv をインストールした後、次のステップとして Python プロジェクトの作成と、それに伴う仮想環境の設定があります。Pipenv を使用すると、プロジェクトごとに独立した仮想環境を簡単に作成し、管理することができます。これはプロジェクトの依存関係を整理し、異なるプロジェクト間でのパッケージの衝突を避けるのに役立ちます。

プロジェクトディレクトリの作成

新しいプロジェクトを始めるには、まずプロジェクト用のディレクトリを作成します。例えば、myproject という名前のディレクトリを作成するには、以下のコマンドを使用します。
```
mkdir myproject
cd myproject
```
仮想環境の作成

プロジェクトディレクトリ内で、以下のコマンドを実行して Pipenv の仮想環境を作成します。
```
pipenv install
```
このコマンドは、現在のプロジェクトに対して新しい仮想環境を作成し、プロジェクトの依存関係を管理するための Pipfile を自動的に生成します。
Pipfile の確認

pipenv install コマンドの実行後、プロジェクトディレクトリ内に Pipfile が作成されています。このファイルは、プロジェクトの依存関係を記述し、プロジェクトがどのパッケージに依存しているかをPipenv と他の開発者に伝えます。

以上の手順で、Pipenv を使用した Python プロジェクトの作成と仮想環境の設定が完了します。これにより、プロジェクトの依存関係を効果的に管理し、開発プロセスをよりスムーズに進めることができます。

パス設定（必要な場合）

Pipenv をインストールした後、システムの PATH に Pipenv のインストールパスを追加する必要があるかもしれません。これは、どこからでも Pipenv コマンドを実行できるようにするためです。多くの場合、pip は自動的に適切なパスを設定しますが、うまくいかない場合は、以下の手順に従ってください。

Windows

Pipenv がインストールされたパスを環境変数の PATH に追加します。これは通常、C:\\Users\\<ユーザー名>\\AppData\\Roaming\\Python\\Python<バージョン>\\Scripts のようなパスです。
macOS/Linux

ターミナルを開き、次のコマンドを実行して Pipenv のインストールパスを確認します。
```
pipenv --venv
```
出力されたパスを、~/.bash_profile, ~/.zshrc, または使用しているシェルの設定ファイルに追加します。
```
export PATH="$PATH:/path/to/pipenv"
```
変更を有効にするためには、設定ファイルを再読み込みするか、新しいターミナルセッションを開始してください。

これで、Pipenv のインストールは完了です。次のセクションでは、Pipenv を使用して Python プロジェクトの仮想環境を作成し、依存関係を管理する基本的な方法について説明します。

Pipenv の基本的な使い方

Pipenv を使用すると、Python プロジェクトの依存関係管理と仮想環境の管理が簡単になります。ここでは、Pipenv の基本的な使い方について説明します。

仮想環境の作成

プロジェクトディレクトリ内で以下のコマンドを実行することで、Pipenv は自動的に仮想環境を作成します。もしプロジェクトディレクトリがまだない場合は、新しくディレクトリを作成してからコマンドを実行してください。
```
cd /path/to/project
pipenv install
```
パッケージのインストール

プロジェクトに必要なパッケージをインストールするには、pipenv install コマンドに続けてパッケージ名を指定します。
```
pipenv install requests
```
このコマンドは、requests パッケージを仮想環境にインストールし、プロジェクトの依存関係をPipfileに追加します。
開発用パッケージのインストール

開発中にのみ必要なパッケージ（例：lintツールやテストフレームワーク）は、--dev オプションを付けてインストールします。
```
pipenv install pytest --dev
```
仮想環境のアクティベート

Pipenv で作成された仮想環境をアクティベート（有効化）するには、以下のコマンドを使用します。
```
pipenv shell
```
このコマンドにより、仮想環境がアクティベートされ、その環境内で Python や他のコマンドを実行できるようになります。
仮想環境の終了

仮想環境を終了し、通常のシェル環境に戻るには、exit コマンドを実行します。
```
exit
```
パッケージのアンインストール

プロジェクトから特定のパッケージを削除するには、pipenv uninstall コマンドを使用します。
```
pipenv uninstall requests
```
Pipfile と Pipfile.lock
- Pipfile はプロジェクトの依存関係を宣言的に記述するファイルです。
- Pipfile.lock は、プロジェクトの依存関係の具体的なバージョンを含むロックファイルで、環境を一貫性があり再現可能にします。
依存関係のロック

プロジェクトの依存関係をPipfile.lockにロック（固定）し、他の環境で正確に再現するには、以下のコマンドを使用します。
```
pipenv lock
```

これらは Pipenv を使用する上での基本的な操作です。Pipenv を使用することで、プロジェクトの依存関係管理と仮想環境の管理が簡単になり、Python プロジェクトの開発効率が大きく向上します。

Pipenv の応用的な使い方

Pipenv は、基本的な依存関係管理と仮想環境の作成を超えて、さまざまな応用的な機能を提供します。これらの機能を利用することで、開発プロセスをさらに効率化し、プロジェクトの品質を向上させることができます。

特定のPythonバージョンの指定

プロジェクトで使用するPythonのバージョンをPipfileで指定することができます。これにより、チーム内でのPythonのバージョンの統一が保証されます。
```
[requires]
python_version = "3.8"
```
開発環境と本番環境の分離

pipenv install --devを使用してインストールした開発用のパッケージは、本番環境にはインストールされません。これにより、開発環境と本番環境を効果的に分離できます。
スクリプトの実行

Pipfileにスクリプトを定義し、pipenv runコマンドを使用してそれらのスクリプトを実行することができます。これにより、複雑なコマンドを簡単に実行できるようになります。
```
[scripts]
test = "pytest"
```
実行方法は次の通り。
```
pipenv run test
```
パッケージのセキュリティチェック

pipenv check コマンドを使用して、プロジェクトの依存関係に脆弱性がないかをチェックできます。これにより、セキュリティリスクを早期に発見し、対処することができます。
```
pipenv check
```
グラフの表示

pipenv graph コマンドを使用して、プロジェクトの依存関係のグラフを表示できます。これにより、パッケージ間の関係を視覚的に理解することができます。
```
pipenv graph
```
本番環境でのパッケージインストール

pipenv install --ignore-pipfile を使用することで、Pipfile.lock に基づいてパッケージをインストールし、開発環境と完全に同じ環境を本番環境に作成することができます。Pipfile.lockに基づいて依存関係をインストールすることで、開発環境と本番環境の間で一貫性を保つために特に有用です。
```
pipenv install --ignore-pipfile
```

以上の通り、Pipenv をフルに活用することで、Python プロジェクトの開発・管理・デプロイメントをより効率的に行うことができます。

まとめ

この記事では、Pipenvの導入からパッケージ管理の基本・応用までを解説しました。

学んだ内容：

この記事の要点は以下の通りです。

Pipenvは仮想環境の作成とパッケージ管理を一元化するCLIツール
PipfileとPipfile.lockによる依存関係の明確な管理と再現性のあるビルド
pipenv install --devによる開発用・本番用パッケージの分離
pipenv graphによる依存関係の可視化やpipenv checkによるセキュリティチェック
pipenv runや.envファイルを活用した応用的なワークフロー

Pipenvの基本操作を身につけたことで、venv+pip+requirements.txtで感じていた環境管理の手間が大幅に軽減されるはずです。まずは普段のプロジェクトにPipenvを導入して、チームでの環境共有やパッケージ管理の効率化を実感してみてください。

参考資料

Pipenvについてさらに詳しく学びたい方は、以下のリソースをご覧ください。

Pipenv: Python Development Workflow for Humans
- 公式ドキュメント。Pipenvの使用方法や機能について詳しく解説しています。 https://pipenv.pypa.io/en/latest/

【番外編】USBも知らなかった私が独学でプログラミングを勉強してGAFAに入社するまでの話

IT未経験者必見 USBも知らなかった私が独学でプログラミングを勉強してGAFAに入社するまでの話

プログラミング塾に半年通えば、一人前になれると思っているあなた。それ、勘違いですよ。「なぜ間違いなの？」「正しい勉強法とは何なの？」ITを学び始める全ての人に知って欲しい。そう思って書きました。是非読んでみてください。

「フリーランスエンジニア」

近年やっと世間に浸透した言葉だ。ひと昔まえ、終身雇用は当たり前で、大企業に就職することは一種のステータスだった。しかし、そんな時代も終わり「優秀な人材は転職する」ことが当たり前の時代となる。フリーランスエンジニアに高価値が付く現在、ネットを見ると「未経験でも年収400万以上」などと書いてある。これに釣られて、多くの人がフリーランスになろうとITの世界に入ってきている。私もその中の1人だ。数年前、USBも知らない状態からITの世界に没入し、そこから約2年間、毎日勉学を行なった。他人の何十倍も努力した。そして、企業研修やIT塾で数多くの受講生の指導経験も得た。そこで私は、伸びるエンジニアとそうでないエンジニアをたくさん見てきた。そして、稼げるエンジニア、稼げないエンジニアを見てきた。

「成功する人とそうでない人の違いは何か？」

私が出した答えは、「量産型エンジニアか否か」である。今のエンジニア市場には、量産型エンジニアが溢れている！！ここでの量産型エンジニアの定義は以下の通りである。

比較的簡単に学習可能なWebフレームワーク（WordPress, Rails）やPython等の知識はあるが、ITの基本概念を理解していないため、単調な作業しかこなすことができないエンジニアのこと。

多くの人がフリーランスエンジニアを目指す時代に中途半端な知識や技術力でこの世界に飛び込むと返って過酷な労働条件で働くことになる。そこで、エンジニアを目指すあなたがどう学習していくべきかを私の経験を交えて書こうと思った。続きはこちらから、、、、