Pythonパッケージ管理の基本操作

Python開発において、外部ライブラリの適切なインストールは必須スキルです。ここでは代表的なインストール方法を詳細に解説します。

方法1：pipによる標準インストール

最も基本的なインストール手法はpipコマンドを直接使用する方法です。

最新版のインストール

python -m pip install パッケージ名

例：pandasライブラリをインストールする場合

python -m pip install pandas

バージョン指定インストール

python -m pip install パッケージ名==バージョン番号

例：pandas 1.5.3をインストールする場合

python -m pip install pandas==1.5.3

方法2：ミラーサイト経由の高速インストール

標準のPyPIサーバーが遅い場合や接続が不安定な場合は、国内ミラーサイトの利用を推奨します。

一時的なミラー指定

python -m pip install パッケージ名 -i https://pypi.tuna.tsinghua.edu.cn/simple

例：numpyを清華大学ミラー経由でインストール

python -m pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple

永続的なミラー設定

設定ファイルを編集してデフォルトのミラーを指定できます：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

方法3：オフラインインストール

インターネット接続がない環境や、標準方法でインストールできない場合はWheelファイルを使用します。

Wheelファイルのダウンロード

1. PyPI公式サイトにアクセス

2. 必要なパッケージを検索

3. 環境に適したバージョンを選択：

• Pythonバージョン（例：cp39 = Python 3.9）
• OS（win32/win_amd64）
• アーキテクチャ（32bit/64bit）

ローカルインストール実行

python -m pip install C:\downloads\ファイル名.whl

例：ダウンロードしたscipy wheelをインストール

python -m pip install C:\downloads\scipy-1.11.1-cp39-cp39-win_amd64.whl

トラブルシューティング

一般的なエラーと対処法

Permission Error：

python -m pip install パッケージ名 --user

SSL Certificate Error：

python -m pip install パッケージ名 --trusted-host pypi.org --trusted-host files.pythonhosted.org

Requirement Already Satisfied：

python -m pip install パッケージ名 --upgrade --force-reinstall

開発環境のベストプラクティス

プロジェクトごとに仮想環境を作成することで、依存関係の衝突を防ぎます：

python -m venv myenv
myenv\Scripts\activate
pip install -r requirements.txt

requirements.txtファイルにより、チーム間で同じ環境を再現できます。