Contents
公式インストーラのダウンロードと PATH 設定
このセクションでは、Python 本体を Windows にインストールし、システム全体から python コマンドが呼び出せるように PATH に自動登録する手順を説明します。
インストーラのバージョンによってチェック項目名が若干異なる点に注意してください。
ダウンロードとインストール（概要）
- 公式ダウンロードページへアクセスし、「Download Python (最新安定版)」 ボタンをクリック。
- ダウンロードした
python‑<version>‑amd64.exeを実行し、画面下部にある PATH 設定オプション に必ずチェックを入れてからインストールを開始します。
インストーラで確認すべき PATH 設定項目
| インストーラのバージョン | 表示されるチェック項目名例 |
|---|---|
| 2024‑以降（標準 UI） | 「Add Python to PATH」 |
| 2025‑以降（Python 3.x 系） | 「Add Python 3.x to PATH」 |
| 一部カスタムビルド | 「Add Python 3.x to environment variables」 |
ポイント：上記のいずれかにチェックが入っていることを必ず確認してください。これが無いと
python --versionが認識されません。
インストール後の動作確認
PowerShell もしくはコマンドプロンプトを起動し、次のコマンドを入力します。
|
1 2 |
python --version |
Python <最新安定版> と表示されればインストール完了です。
シェルの選択とプロジェクトディレクトリの作成
ここでは、開発に使用するシェル（PowerShell 推奨）と、プロジェクトごとの作業フォルダを用意する手順を示します。
シェルは後述の仮想環境有効化で必要になるため、最初に決めておくとスムーズです。
PowerShell を推奨する理由（概要）
PowerShell はオブジェクト指向のパイプラインを備えており、venv の有効化や VS Code との連携が自然に行えます。
CMD でも動作は可能ですが、スクリプト実行時に余計な設定が必要になるケースが多いです。
作業ディレクトリの作成例（PowerShell）
以下のコマンドでプロジェクトフォルダを作り、カレントディレクトリを移動します。
Set-Location は cd のエイリアスなので、どちらでも同等です。
|
1 2 3 4 |
# プロジェクト名は任意に変更してください mkdir MyProject Set-Location .\MyProject # ← cd と同等 |
ポイント：プロジェクトフォルダは英数字のみ（例
C:\Projects\MyApp）で作成すると、後のトラブルが減ります。
venv で仮想環境を構築・有効化
この章では標準ライブラリ venv を使って、プロジェクトごとに独立した Python 環境を作成し、PowerShell 上で有効化する手順を解説します。
仮想環境の作成（概要）
カレントディレクトリ直下に .venv フォルダが生成され、そこに Python 本体と pip がコピーされます。
|
1 2 |
python -m venv .venv |
実行後は特別な設定なしでフォルダ構造が出来上がります。
PowerShell だけで完結する有効化手順
PowerShell の既定ポリシーではスクリプトの実行がブロックされますが、プロセス単位で一時的に緩和すれば Activate.ps1 が問題なく動作します。
|
1 2 3 4 5 6 |
# ① 実行ポリシーを現在の PowerShell プロセスだけ緩和 Set-ExecutionPolicy RemoteSigned -Scope Process # ② 仮想環境を有効化 .\.venv\Scripts\Activate.ps1 |
RemoteSignedはローカルに保存されたスクリプトを許可し、インターネットから取得したものは署名が必要です。-Scope Processを付けることで、PowerShell ウィンドウを閉じた瞬間に元のポリシーに戻ります。
Cmd で有効化する場合（参考）
| シェル | 有効化コマンド |
|---|---|
| PowerShell | .\.venv\Scripts\Activate.ps1 |
| CMD | .\\.venv\\Scripts\\activate.bat |
PowerShell 推奨の理由は、上記のように 一行で有効化でき、後続のスクリプトでも高度なロジックが書ける ことです。
VS Code と Python 拡張機能による仮想環境連携
VS Code は軽快なエディタとしてだけでなく、Python 開発を支える便利機能が多数搭載されています。ここでは 公式 Python 拡張機能 が .venv を自動検出し、インタプリタ選択までをシームレスに行う手順を示します。
拡張機能の導入と自動検出（概要）
- VS Code の拡張マーケットプレイスで 「Python」（Microsoft 提供）をインストール。
- プロジェクトフォルダ（例
MyProject）を VS Code で開くと、左下ステータスバーに Python バージョンが表示されます。
ポイント：
.venvが存在すれば拡張機能が自動的に「.venv (Python <最新安定版>)」として認識します。手動で選択したい場合はステータスバーをクリックし、一覧から該当のpython.exeを選んでください。
手順詳細
|
1 2 3 4 5 |
① VS Code でプロジェクトフォルダを開く ② 左下ステータスバーの Python バージョン表示をクリック ③ 「Enter interpreter path...」 → 「Find…」 を選択 ④ .venv\Scripts\python.exe を選ぶ |
この設定は .vscode/settings.json に保存され、同フォルダを再度開いたときに自動適用されます。
パッケージ管理（requirements.txt の活用）
依存ライブラリは requirements.txt に列挙し、仮想環境が有効な状態で次のコマンドを実行します。
|
1 2 |
pip install -r requirements.txt |
例として以下のように記述できます（バージョン固定推奨）：
|
1 2 3 4 |
fastapi==0.110.0 uvicorn[standard]==0.27.0 pydantic==2.6.1 |
これでチーム全員が同一環境を再現でき、CI/CD パイプラインでも同様にインストール可能です。
仮想環境の停止と削除
作業終了時は以下のコマンドで仮想環境を無効化し、不要になったらフォルダごと削除します。
|
1 2 3 4 5 6 |
# 無効化 deactivate # フォルダ削除（完全にクリーンアップ） Remove-Item -Recurse -Force .\.venv |
トラブルシューティングと追加情報
実務で遭遇しやすいエラーとその対処法をまとめました。まずは原因を特定し、下表の対応策を試してください。
主なエラー例と解決策（概要）
| エラー内容 | 主な原因 | 推奨対処 |
|---|---|---|
python が認識されない |
PATH 未登録 | 再インストール時に 「Add Python to PATH」 にチェック、または手動で環境変数 C:\Users\<User>\AppData\Local\Programs\Python\Python<ver>\ を追加 |
| 仮想環境の Activate が失敗 | 実行ポリシー制限 | Set-ExecutionPolicy RemoteSigned -Scope Process を実行（プロセス単位で一時緩和） |
| プロジェクトパスに日本語が含まれる | Unicode 非対応スクリプト | フォルダは英数字のみのパス（例 C:\Projects\MyApp）に変更 |
pip が見つからない |
venv 作成時に ensurepip 無効化 |
python -m ensurepip --upgrade で pip を復元 |
| 権限不足でフォルダ作成失敗 | 管理者権限が必要な場所 | ユーザ領域（ %USERPROFILE%\Documents\Projects ）へ作業を移す |
複数バージョン管理のオプション：pyenv‑win + venv
プロジェクトごとに異なる Python バージョンを使いたい場合は、pyenv‑win と venv の組み合わせが便利です。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
# ① pyenv-win を Chocolatey 経由でインストール choco install pyenv-win -y # ② 任意のバージョン（例 3.12.4）を取得 pyenv install 3.12.4 # ③ プロジェクトディレクトリでバージョン固定 cd C:\Projects\MyApp pyenv local 3.12.4 # ④ venv で仮想環境作成（先ほどと同様） python -m venv .venv |
この手順により、Python 本体の切り替え と 依存分離 の二重保護が得られます。詳細は公式リポジトリや Qiita 記事（「【Windows】pyenv + venvでPython仮想環境を構築する手順」）をご参照ください。
まとめ
- 公式インストーラの PATH 設定項目（例：
Add Python to PATH、Add Python 3.x to PATH）に必ずチェックし、python --versionで確認する。 - PowerShell 推奨：
Set-ExecutionPolicy RemoteSigned -Scope Processで一時的に実行ポリシーを緩和すればActivate.ps1が即座に使用可能。 python -m venv .venvによる仮想環境は VS Code の Python 拡張機能が自動検出し、インタプリタ選択がシームレスになる。- 依存ライブラリは requirements.txt と
pip install -rで一括管理し、作業終了後はdeactivateと.venvフォルダ削除でクリーンアップ。 - エラーの多くは PATH 設定・実行ポリシー・日本語パス が原因。上記対策を覚えておけば、ほとんどの障害は即解決できる。
- 複数バージョンが必要な場合は pyenv‑win + venv の組み合わせが最も手軽で拡張性が高い。
この手順に従えば、Windows 環境でも安全かつ効率的に Python 開発環境を構築でき、以降の学習や実務プロジェクトへスムーズに移行できます。 Happy coding!