WindowsでPythonとPipを動作させる方法

WindowsでPythonとpipを動作させるには、公式のPythonインストールマネージャーをインストールし、PowerShellを開いて、ターミナルからPythonを起動します。pipは通常Pythonに付属しています。python -m pipパッケージコマンドが意図したインタープリタで実行されるように設定し、各プロジェクトの仮想環境を作成して依存関係を分離します。

以前の手順では、Microsoft Storeの固定バージョンから選択するか、ダウンロードすることを推奨していましたget-pip.pyが、これはもはや最も簡単な設定方法ではありません。現在のPythonドキュメントでは、Python.orgまたはMicrosoft Storeから入手できるPython Install Managerの使用を推奨しています。このマネージャーはPythonランタイムを管理し、ensurepip特定のインストールでpipが欠落している場合はpipを復元できます。

1. WindowsにPythonをインストールする

1. 公式のPythonダウンロードページを開くか、Microsoft Storeを開いて「Python Install Manager」を検索してください。どちらのマネージャー配布版も同等です。発行元がPython Software Foundationであることを確認し、アプリをインストールしてください。
2. 新しい PowerShell ウィンドウを開きます。 を実行しますpython --version。 Python ランタイムがまだインストールされていない場合、マネージャーは Python を初めて起動したときに最新の安定版をインストールできます。 を実行するpy listと、マネージャーが認識しているランタイムを確認できます。
3. プロジェクトで特定の Python バージョンが必要な場合は、そのバージョンを明示的にインストールしてくださいpy install 3.15。たとえば、`python.py` のように記述します。バージョンを選択する前に、プロジェクト独自の要件を確認してください。最新リリースがすべての古いアプリケーションと自動的に互換性があるとは限りません。

新規設定の場合は、python通常、デフォルトのコマンドで十分です。以下のコマンドで結果を確認してください。

python --version
py list

最初のコマンドはインタープリタのバージョンを表示し、2 番目のコマンドはインストールされているランタイムの一覧を表示します。正確なバージョン番号は、Python のリリースに応じて変更されます。スクリプトをフォルダから実行するには、 を使用しますpython .\script.py。マネージャー、エイリアス、および Windows の設定の詳細については、公式の Python on Windows ガイドを参照してください。

2. パイプを点検し、必要な場合のみ修理する

先ほどインストールしたPythonインタープリタにpipが接続されていることを確認してください。

python -m pip --version

出力には、pipとそのPythonバージョンが識別されます。コマンドが正常に動作した場合は、以下のコマンドでpipを更新できます。

python -m pip install --upgrade pip

Python がエラーを報告する場合はNo module named pip、別のスクリプトをダウンロードする代わりに、Python にバンドルされているブートストラップ モジュールを使用してください。

python -m ensurepip --upgrade

次に、pip のバージョンチェックを再度実行してください。このensurepipツールは Python に付属のコンポーネントを使用するため、サードパーティのサイトからインストーラーを取得することはありません。利用可能なオプションが必要な場合は、 ensurepip のドキュメントを参照してください。

3. プロジェクト環境にパッケージをインストールする

すべてのパッケージをグローバルにインストールすると、プロジェクト同士が干渉し合う可能性があります。仮想環境では、パッケージを1つのプロジェクト専用のフォルダに保持します。PowerShellでプロジェクトディレクトリに移動し、環境を作成します。

py -m venv .venv
.\.venv\Scripts\Activate.ps1

アクティベーション後、PowerShellは通常(.venv)プロンプトに以下を追加します。上記で使用したのと同じインタープリタバインドコマンドを使用してパッケージをインストールします。

python -m pip install requests

requestsプロジェクトに必要なパッケージ名に置き換えてください。pip でインストールされたパッケージを確認するには、 を実行しますpython -m pip show requests。環境での作業が終了したら、 と入力しますdeactivate。環境はディスク上に保存され、後で再度アクティブ化できます。

PowerShellがスクリプト実行ポリシーのためにブロックする場合Activate.ps1、パッケージをインストールするためだけにマシン全体の設定を変更する必要はありません。代わりに、環境のインタープリタを直接呼び出してください。

.\.venv\Scripts\python.exe -m pip install requests

これは、環境をアクティブ化せずに、その環境内でpipを実行します。Pythonガイドでは、Windowsvenv上で環境を作成および使用する方法について説明しています。

Pythonとpipの一般的な問題を修正する

• 「Python が見つかりませんでした」というエラーメッセージが表示されるか、コマンドを実行するとストアが開く場合は、インストール マネージャーがインストールされていることを確認し、スタートメニューを開いて「アプリ実行エイリアスの管理」を検索してください。 が有効になっていることを確認してくださいPython (default)。既に有効になっている場合は、一度無効にしてから再度有効にしてコマンドを更新してください。その後、 を試してくださいpy list。その他のエイリアスまたはランタイムの競合については、 Windows の公式トラブルシューティング手順を参照してください。
• 「pip が認識されません」:python -m pipスタンドアロン コマンドではなく、を実行しますpip。これにより、 に別の Scripts フォルダーが追加されることに依存しなくなりますPATH。
• パッケージが間違った Python にインストールされます:python --versionと比較してくださいpython -m pip --version。複数のバージョンを管理している場合は、たとえば Windows ランチャーを使用して目的のバージョンを選択してくださいpy -3.15 -m pip --version。

バージョンチェックとpipチェックの両方が正常に完了すれば、WindowsはPythonスクリプトの実行とプロジェクトの依存関係のインストールに対応できます。Pythonパッケージングユーザーガイドには、pipと環境に関するその他の例が記載されています。