Windows で Python と VS Code をインストールし、PATH 設定・仮想環境・デバッグまで完全ガイド

bash
python -m venv .venv

1. Windows の場合は次のコマンドで有効化します。

bat
.\.venv\Scripts\activate
4. コマンドパレット（Ctrl+Shift+P）を開き 「Python: Select Interpreter」 を選択。表示された一覧から .venv\Scripts\python.exe をクリックします。

補足情報

エディタ基本設定：IntelliSense・Linting・フォーマッタ

快適なコーディング体験のために コード補完 (IntelliSense)、静的解析 (pylint)、自動整形 (black) を有効化します。このセクションでは、settings.json に追記すべき設定項目とその効果をまとめます。

settings.json への追記例

ポイント：プロジェクト単位で設定したい場合は .vscode/settings.json に書くと、他のプロジェクトに影響しません。

機能確認手順

1. IntelliSense：import math と入力し、 math. の後に候補が表示されるか確認。
2. pylint：未使用変数やインデントエラーが赤い波線でハイライトされることをチェック。
3. black：任意の Python ファイルで改行位置やインデントを乱して保存 (Ctrl+S) すると、PEP 8 に沿った形に自動整形されます。

補足情報

デバッグ構成の作成とサンプル実行

VS Code のデバッガは launch.json に記述された設定を基に動作します。このセクションでは 自動生成されたテンプレートをそのまま利用し、簡単なスクリプトで 3 通りの実行方法（ターミナル・Run ボタン・デバッグ） を体験する手順を示します。

デバッグ構成作成

1. 左側の「Run and Debug」ビュー（虫眼鏡アイコン）を開く。
2. 「Run and Debug」のボタンをクリックし、表示されるリストから 「Python File」 → 「Add Configuration…」 を選択すると、以下の launch.json が自動生成されます。

json
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal"
}
]
}

サンプルスクリプト

プロジェクト直下に hello.py を作成し、次のコードを貼り付けます。

3 通りの実行方法

注意点：デバッグ時は必ず仮想環境が有効化されたターミナルから VS Code を起動すると、選択したインタプリタとパッケージが正しく反映されます。

トラブルシューティングと次の学習ステップ

実際にセットアップを進めると PATH が認識されない・拡張機能が読み込まれない・仮想環境が検出できない といったエラーが発生しやすくなります。この章では、代表的な症状と対処法を表形式でまとめ、さらに次に学ぶべきリソースをご紹介します。

代表的なエラーと対処法

次に学ぶべきリソース

1. 公式ドキュメント
2. Python Windows インストーラ: https://www.python.org/downloads/windows/

3. VS Code Python 拡張チュートリアル: https://code.visualstudio.com/docs/python/python-tutorial

4. 実践ハンズオン

5. GitHub リポジトリ python-handson/sample-project（クローン後、README の手順に従って環境構築 → テストスクリプト実行）

6. 応用トピック

7. poetry や pipenv を使った依存管理
8. Docker コンテナ上での VS Code Remote Development

まとめ

• Python 本体は公式インストーラの 「Add Python to PATH」 に必ずチェックし、管理者権限が必要な場合は UAC を許可する。
• VS Codeは最新版（執筆時点 1.89 系）を導入し、Microsoft 製 Python 拡張で自動依存解決を活用。古い Windows でも「Older versions」から適切なバージョンが取得可能。
• 仮想環境 (venv) はプロジェクト直下に .venv を作成し、VS Code のコマンドパレットでインタプリタを選択すれば、依存関係の分離が完了する。
• エディタ設定は settings.json に数行追記するだけで IntelliSense・pylint・black が連携し、コード品質と可読性が向上する。
• デバッグは自動生成された launch.json をそのまま使用し、ブレークポイントや変数ウォッチを活用すれば、実行結果の確認が容易になる。
• トラブル対処は PATH の再確認・ウィンドウリロード・仮想環境の再作成で多く解決でき、公式ドキュメントとハンズオンで更なるスキルアップが可能。

以上の手順を踏めば、Windows 環境において VS Code と公式 Python ランタイムがシームレスに連携し、快適な開発・デバッグ体験が得られます。ぜひ本稿を参考に実際のプロジェクトで試してみてください。