はじめに｜requirements.txtってなに？なんで使うの？

Pythonでプログラムを作っていると、「自分の環境では動くのに、別のパソコンだとエラーが出る…」という経験はありませんか？ その原因の多くは、必要なライブラリがインストールされていないことです。

Pythonでは、使用しているライブラリを一括でインストールできる便利な仕組みとして requirements.txt というファイルが用意されています。 このファイルを使えば、複数のライブラリを1つずつ入れる必要はなく、コマンド一発で開発環境を再現できます。

たとえば、次のような場面で requirements.txt は大活躍します。

• 自分のPCで作ったPythonプログラムを、別のPCでも同じように動かしたいとき
• チーム開発で、全員のライブラリ環境を揃えたいとき
• GitHubなどでコードを公開し、他の人に簡単に実行してもらいたいとき

requirements.txt に書く内容はとてもシンプルで、Flask==2.2.2 のように 「ライブラリ名とバージョン」を並べるだけ。 手動で作成することも、自動で生成することもできます。

この記事では、Python初心者の方でもつまずかないように、 requirements.txt の役割・作り方・使い方を順番にやさしく解説します。 「Pythonの環境構築がいつも不安…」という方は、ぜひ参考にしてみてください。

1. requirements.txtとは？役割とメリット

requirements.txt（リクワイアメンツ ドット ティーエックスティー）は、Pythonのプロジェクトでよく使われるライブラリの一覧表のようなものです。中には「このプロジェクトではどんなライブラリが、どのバージョンで必要か？」という情報がズラッと書かれています。

✅ じゃあ何のために使うの？

一言でいうと、**「同じ環境をすぐに再現するため」**です。

Pythonで何かアプリやツールを作ったとき、それを他の人に渡すだけでは、うまく動かないことがよくあります。
なぜかというと、「自分のパソコンでは必要なライブラリが入っているけど、相手のパソコンには入っていない」から。

でも、requirements.txtを使えば安心！

pip install -r requirements.txt

このコマンドを一発打てば、中に書かれたライブラリが全部まとめてインストールされるんです。しかも、バージョン指定もできるので、自分と相手で同じ環境がカンタンに作れます。

✅ メリットまとめ！

「Pythonのプロジェクトをもっとスムーズに動かしたい」「環境構築でエラーを減らしたい」と思っているなら、requirements.txtは必須アイテムです！

次は、このファイルをどうやって作るのか、実際のコマンドを使って見ていきましょう！

2. pip freezeでrequirements.txtを作る方法

「requirements.txtって便利そうだけど、どうやって作るの？」
安心してください！作り方はとっても簡単。たった1行のコマンドを実行するだけなんです。

✅ pip freezeコマンドとは？

Pythonには「pip（ピップ）」というライブラリ管理ツールが最初からついています。
そのpipに「freeze（フリーズ）」というコマンドを使うと、今自分の環境にインストールされているライブラリの一覧を表示してくれます。

実際にコマンドを打ってみましょう！

pip freeze

すると、こんなふうに表示されます：

Flask==2.2.2
requests==2.31.0
numpy==1.24.3

この結果を見れば、どんなライブラリが、どのバージョンで入っているかがひと目でわかりますね。

✅ ファイルに保存するには？

さきほどの情報を、そのままrequirements.txtという名前で保存するには、次のコマンドを実行します：

pip freeze > requirements.txt

これで、カレントディレクトリ（今いる場所）に requirements.txt というファイルが作成され、中にはインストール済みのライブラリ一覧が書き込まれています。

✅ 作られたファイルの中身（例）

Flask==2.2.2
requests==2.31.0
numpy==1.24.3

この形式、「パッケージ名==バージョン番号」になっているのがポイントです！
これがあるから、あとで同じ状態を再現できるわけですね。

✅ 小ワザ：不要なライブラリを除外したいときは？

「開発中に入れてたけど、本番には必要ないな…」というライブラリもあるかもしれません。
そんなときは、requirements.txtをテキストエディタで開いて、いらない行を手動で削除すればOKです。

これで、あなたのPython環境をまるごと記録した「requirements.txt」ができあがりました！
次は、このファイルを使ってライブラリを一括インストールする方法を解説していきますよ。

3. requirements.txtから一括インストールする方法

さて、前の章で作ったrequirements.txt。
このファイルがあれば、一つずつライブラリをインストールする手間はもういりません！

Pythonの環境を一気に再現するには、たった一行のコマンドでOKなんです。

✅ 一括インストールのコマンド

pip install -r requirements.txt

このコマンドを実行すると、requirements.txtに書かれているすべてのライブラリが、そのとおりのバージョンでインストールされます。

例：

Flask==2.2.2
requests==2.31.0

と書かれていた場合は、Flaskのバージョン2.2.2、requestsのバージョン2.31.0が自動で入ります。
しかも順番にまとめてやってくれるから、すっごくラク！

✅ 実行の流れ（イメージ）

1. requirements.txtをプロジェクトフォルダに置く
2. ターミナルやコマンドプロンプトを開く
3. cdコマンドでそのフォルダに移動
4. pip install -r requirements.txtを実行！
5. インストール完了！

これで準備完了！同じPythonコードを他のPCでもそのまま動かすことができます。

✅ よくあるエラーとその対処法

✅ ポイント：仮想環境と一緒に使うと最強！

実は、requirements.txtは**仮想環境（venv）**とセットで使うともっと便利なんです！
他のプロジェクトの環境と混ざらずに、キレイに管理できます。

これで、requirements.txtからライブラリを一括でインストールする方法がバッチリ分かりましたね！

4. requirements.txtを編集・活用する小技

requirements.txtは、ただのテキストファイル。
つまり、自分で開いて自由に編集できるんです！

ちょっとした工夫で、もっと便利に活用できるので、いくつかの小技をご紹介します。

✅ 小技①：手動でパッケージを追加・削除できる

「このライブラリだけ入れてほしい」とか、「これは開発のときだけ使うからいらないな〜」ってとき、ありますよね。

そんなときは、テキストエディタで開いて、いらない行を削除するだけでOK！
逆に、必要なライブラリを追加したいときは、こう書けばいいです：

requests==2.31.0
numpy==1.24.3

「パッケージ名==バージョン番号」という書き方さえ守れば、自由にカスタマイズできます！

✅ 小技②：バージョンをあえて指定しない

ときには「とにかく最新版でいいから、バージョン指定したくない」という場合もありますよね。

そんなときは、バージョン番号を書かずにこんなふうにすればOKです。

flask
requests

これで実行すると、最新版がインストールされます（ただし、環境によって動作が変わる可能性があるので注意！）

✅ 小技③：コメントを書いて整理できる

実は、requirements.txtの中にはコメントも書けます！
行の先頭に「#」をつければ、それは無視されます。

# Webアプリ用
Flask==2.2.2

# データ処理用
pandas==2.0.3
numpy==1.24.3

こうしておけば、他の人が見たときにもわかりやすいし、自分でも後から見て整理しやすいですよ！

✅ 小技④：ファイルを用途別に分ける

大きなプロジェクトでは、「本番用（production）」と「開発用（development）」でライブラリを分けることもよくあります。

requirements.txt
dev-requirements.txt

こんなふうにファイルを分けておくと、以下のように使い分けができます：

pip install -r requirements.txt             # 本番環境用
pip install -r dev-requirements.txt         # 開発環境用

✅ 小技⑤：GitHubに一緒にアップしよう！

PythonプロジェクトをGitHubなどにアップするなら、requirements.txtも一緒に公開しておきましょう！

他の人がそのプロジェクトを使いたいとき、ライブラリがそろってなかったらエラーになってしまいます。
でも、requirements.txtがあれば、すぐにインストールできて再現性もバッチリ！

💡 おまけ：中身を確認したいときは？

requirements.txtの中身をターミナルで見るには、次のコマンドを使えばOK！

cat requirements.txt  # Mac/Linux
type requirements.txt # Windows

ちょっとした確認にも便利ですよ！

これで、requirements.txtの基本から、実践的な使い方までバッチリですね！

まとめ｜requirements.txtでPython環境をラクに再現しよう！

Pythonのプロジェクトでは、環境構築でつまずくことがよくありますよね。
でも、requirements.txtを使えば、ライブラリの一括管理とインストールがとっても簡単になります！

もう一度ポイントをおさらいすると…

✅ 今使っているライブラリの一覧は pip freeze > requirements.txt で出力！
✅ 新しい環境では pip install -r requirements.txt で一括インストール！
✅ ファイルは手動で編集・整理できて、バージョン指定も自由自在！

つまり、requirements.txtを使いこなせば、自分もチームも他の人も、同じPython環境で安心して開発できるようになります。
はじめは難しそうに見えるかもしれませんが、一度覚えてしまえばずっと使える便利ワザですよ！

あわせて読みたい

• 🔗 【Win/Mac対応】Pythonスクリプトをexe化！PyInstallerで実行ファイルを作る方法
  → 作ったアプリを配布したいときに役立つ実行ファイル化の手順！

よくある質問（Q&A）