UbuntuでPython pipをインストールして使う方法

UbuntuでPythonのパッケージ管理ツール「pip」をインストールして使う方法を解説します。結論から言うと、sudo apt install python3-pip でインストールできますが、Ubuntu 24.04 LTS では PEP 668 の仕様変更により、pip で直接パッケージをインストールしようとするとエラーが発生します。この記事では実際に Docker コンテナで検証した結果をもとに、正しい使い方と詰まりやすいポイントを丁寧に説明します。

本記事では ubuntu:24.04 / ubuntu:22.04 の Docker 公式イメージで実際にコマンドを実行し、その結果を載せています。

目次

1. 前提環境・確認済みバージョン
2. pip のインストール手順（Ubuntu 24.04）
3. Ubuntu 24.04 で pip install するとエラーが出る理由（PEP 668）
4. 正しい使い方：仮想環境（venv）で pip install する
5. pip の基本的な使い方
6. Ubuntu 22.04 と 24.04 の違い（実測比較）
7. よくあるエラーと解決策
8. まとめ

前提環境・確認済みバージョン

本記事のコマンドは以下の環境で実際に動作確認しています。

pip のインストール手順（Ubuntu 24.04）

Ubuntu 24.04 の新規インストール環境（Docker 公式イメージ含む）では、pip は最初から入っていません。apt で明示的にインストールする必要があります。

手順1：パッケージリストを更新する

正直、apt update を忘れがちですが、これをやらないと古いバージョンが入ることがあります。インストール前に必ず実行してください。

手順2：python3-pip をインストールする

手順3：インストールを確認する

pip 24.0 from /usr/lib/python3/dist-packages/pip (python 3.12) と表示されれば成功です。Ubuntu 24.04 では Python 3.12.3 と pip 24.0 の組み合わせが標準です。

Ubuntu 24.04 で pip install するとエラーが出る理由（PEP 668）

pip がインストールできたので早速 pip3 install requests を実行してみましょう。すると、Ubuntu 24.04 では以下のようなエラーが出て止まります。

Ubuntu 22.04 まではこのエラーは出ませんでした。24.04 にアップグレードして突然 pip が使えなくなった！という人が多いのですが、これは仕様変更です。Python の環境を守るための措置で、解決策は仮想環境（venv）を使うことです。

なぜこのエラーが出るのか

Python 3.11 以降、Debian/Ubuntu 系のディストリビューションでは PEP 668（外部管理環境の保護）が実装されました。これは、システムの Python パッケージ管理を apt に任せ、pip で勝手に上書きされないようにする仕組みです。

Ubuntu 22.04 は Python 3.10 ベースなのでこの制限がありませんでしたが、Ubuntu 24.04 は Python 3.12 ベースなので PEP 668 が適用されます。

正しい使い方：仮想環境（venv）で pip install する

Ubuntu 24.04 で pip を使う正しい方法は、仮想環境（venv）を作成してから pip install することです。venv とは Python 専用の隔離された環境で、プロジェクトごとにパッケージを分けて管理できます。

手順1：python3-full をインストールする

venv を使うには python3-full パッケージが必要です（python3-pip だけでは venv が作れない場合があります）。

手順2：仮想環境を作成する

myenv はディレクトリ名です。プロジェクト名や用途に合わせて変えてください（例: venv、.venv、myproject-env など）。

手順3：仮想環境を有効化する

プロンプトの先頭に (myenv) が表示されれば、仮想環境が有効になっています。

手順4：pip install でパッケージをインストールする

エラーなしでインストールできました。requests 2.34.2 が myenv/lib/python3.12/site-packages 以下にインストールされており、システムの Python 環境には一切影響していません。

仮想環境を終了する

deactivate コマンドで仮想環境を抜けられます。プロンプトから (myenv) が消えれば完了です。

pip の基本的な使い方

仮想環境を有効にした状態で使える主要な pip コマンドをまとめます。

①パッケージをインストールする

②インストール済みパッケージを確認する

③requirements.txt を作成する

チームで開発する際や VPS に同じ環境を再現したいときは、pip freeze で現在の環境を書き出しておくと便利です。

④パッケージをアンインストールする

Ubuntu 22.04 と 24.04 の違い（実測比較）

Ubuntu 22.04 から 24.04 にアップグレードした場合や、両方の環境を扱う場合は以下の違いを押さえておきましょう。Docker 公式イメージの ubuntu:22.04 と ubuntu:24.04 で実測した結果です。

Ubuntu 22.04 では pip3 install を venv なしで直接実行できますが、Ubuntu 24.04 では PEP 668 の制限があります。新しいVPSや環境で作業する際は、まず Ubuntu のバージョンを確認する癖をつけておくといいでしょう。

よくあるエラーと解決策

エラー1：externally-managed-environment（Ubuntu 24.04）

原因：Ubuntu 24.04 の PEP 668 制限です。

解決策：python3-full をインストールして venv を使う（推奨）か、--break-system-packages フラグを使う（非推奨・システムが不安定になる可能性あり）。

エラー2：The virtual environment was not created successfully

原因：python3-pip のみインストールした場合に venv の作成に失敗することがあります。

解決策：python3-full をインストールする。

エラー3：pip3: command not found

原因：python3-pip がインストールされていません。

解決策：

まとめ

pip と venv を使いこなすと、プロジェクトごとに独立した Python 環境を作れるようになり、本番 VPS での開発・デプロイが格段に楽になります。次のステップとして、実際に VPS を借りて Python アプリを動かしてみましょう。