初心者でもできる！Python環境構築ガイド【Windows11+Visual Studio Code】

[経緯]
生成AIでコーディングが流行ってきましたね！
でもねぇ，だいたいPythonでAIにコード書いてもらったトコでド素人なんで，使いこなせないどころか実行やテストさえできないのよね。。
そもそもPythonの実行環境さえままならない状況。


と，いうわけでClaudeさんと話し合って以下の構築ガイド作ってもらいました。
「プログラミングなんもわからんけども，Pythonってやつを使いたい」人に使ってもらえたらいいな。
初学者さんとかオカンに紹介してあげてください。
（ただし割と長文ェ・・・）

----解説ｺｺｶﾗ----
# 【Windows版】初心者でもできる！Python環境構築ガイド

## はじめに

プログラミング初心者の方でも迷わずPython環境を構築できるよう、Windows 11を例に画像付きで丁寧に解説します。このガイドでは、プロジェクトごとにPythonの仮想環境を作成し、Visual Studio Code（VS Code）とPylanceで快適に開発できる環境を整えます。

**注意**：このガイドはWindows 11での動作を基準に作成していますが、Windows 10でも同様の手順で環境構築が可能です。

### このガイドで構築する環境
- **Python**：プログラミング言語
- **Pythonインタープリター**：Pythonコードを実行する「通訳者」プログラム
- **venv**：Pythonに標準で含まれる仮想環境ツール
- **Visual Studio Code**：Microsoft製の無料エディタ（IDE）
- **Pylance**：コード補完やエラー検出を提供する拡張機能

### 基本用語と仮想環境の必要性

まず、基本的な用語から説明します：

**プロジェクトとは？**
プログラミングにおける「プロジェクト」は、一つの目的を持ったプログラムのまとまりです。プロジェクトは専用のフォルダで管理します。例えば：
- 「家計簿アプリ」プロジェクト → `household_budget`フォルダ
- 「売上データ分析」プロジェクト → `sales_analysis`フォルダ
- 「Webサイト作成」プロジェクト → `my_website`フォルダ

**ライブラリとは？**
他の人が作った便利な「道具箱」のようなものです。例えば：
- **requests**：Webサイトからデータを取得する道具箱
- **pandas**：データ分析用の道具箱
- **pygame**：ゲーム作成用の道具箱

これらのライブラリを使うことで、一から全て作る必要がなくなります。

**仮想環境とは？**
仮想環境（Virtual Environment）は、**プロジェクトごとに独立したPython実行環境を作る仕組み**です。

もう少し詳しく説明すると：
- コンピュータ内に「隔離された小さなPython環境」を作ります
- その環境内では、特定のバージョンのPythonとライブラリが動作します
- 他のプロジェクトや、システム全体のPython環境に影響を与えません

例えるなら、仮想環境は「プロジェクト専用の作業部屋」のようなものです。その部屋の中では：
- 好きなバージョンの道具（ライブラリ）を置ける
- 他の部屋（プロジェクト）の道具と混ざらない
- 部屋を丸ごと削除しても、他の部屋には影響しない

**なぜ仮想環境が必要なの？**
具体例で説明すると：
- **プロジェクトA（家計簿アプリ）**：pandas バージョン1.5を使用
- **プロジェクトB（古いシステムの保守）**：pandas バージョン1.0を使用

もし仮想環境を使わないと、新しいプロジェクトAのために pandas 1.5をインストールすると、古いプロジェクトBが動かなくなってしまうかもしれません。

仮想環境を使えば、それぞれのプロジェクト専用の「お部屋」でライブラリを管理できるため、お互いに影響を与えることなく開発できます。



## 目次
1. [Pythonのインストール](#1-pythonのインストール)
2. [Visual Studio Codeのインストール](#2-visual-studio-codeのインストール)
   - Python拡張機能とPylanceの導入
3. [最初のプロジェクト作成](#3-最初のプロジェクト作成)
4. [VS Codeの設定](#4-vs-codeの設定)
5. [動作確認](#5-動作確認)
   - Pylanceの機能体験
6. [別プロジェクトの作成方法](#6-別プロジェクトの作成方法)
7. [プロジェクトの切り替え方法](#7-プロジェクトの切り替え方法)
8. [トラブルシューティング](#8-トラブルシューティング)

---

## 1. Pythonのインストール

### ステップ1：Python公式サイトにアクセス
[Python公式サイト](https://www.python.org/downloads/)にアクセスし、「Download Python」ボタンをクリックします。

![2025-06-12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/e6104f86-e0c4-4b61-a238-eda98158297b.png)


### ステップ2：インストーラーの実行
ダウンロードしたインストーラーを実行します。

**⚠️ 重要**：必ず「Add Python to PATH」にチェックを入れてください！これを忘れると後で面倒なことになります。

「Install Now」をクリックしてインストールを開始します。

![2025-06-12 (1).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/b71ccb6b-b677-4b6d-981f-98958c425d19.png)

![2025-06-12 (4).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/1321e9a0-d214-46ce-b50f-f34481c8483f.png)
- インストール完了画面（「Setup was successful」が表示されている）

### ステップ3：インストール確認
PowerShellを開いて、以下のコマンドを実行します：

```powershell
python --version
```

**PowerShellの開き方**：
1. Windowsキー + R を押す
2. 「powershell」と入力してEnter

![2025-06-12 (5).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/406db5b7-0a5a-47bb-95c1-88a4874a5f4d.png)




-  PowerShellでpython --versionを実行した結果

![2025-06-12 (7).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/73b19d3e-6491-4c38-80f5-53ee423ce09a.png)



---

## 2. Visual Studio Codeのインストール

### ステップ1：VS Code公式サイトにアクセス
[Visual Studio Code公式サイト](https://code.visualstudio.com/)にアクセスし、「Download for Windows」をクリックします。
![2025-06-12 (8).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/47446eca-ba04-4862-aacd-5c01e5db3b94.png)


### ステップ2：インストール
ダウンロードしたファイルを実行し、指示に従ってインストールします。基本的にすべてデフォルト設定で問題ありません。


### ステップ3：日本語化（オプション）
VS Codeを起動し、日本語化します。

1. 左側のExtensions（拡張機能）アイコンをクリック（四角が4つ並んだアイコン）
2. 検索欄に「Japanese」と入力
3. 「Japanese Language Pack for Visual Studio Code」をインストール
4. 右下に表示される「Restart」をクリック

![2025-06-12 (15).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/0623a5f9-a687-4320-bd52-56f7b716b610.png)


### ステップ4：Python拡張機能のインストール
Python開発に必要な拡張機能をインストールします。

#### 必須拡張機能1：Python
1. 拡張機能アイコンをクリック
2. 検索欄に「Python」と入力
3. Microsoft製の「Python」拡張機能をインストール（作者がMicrosoftであることを確認）

![2025-06-12 (18).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/0772a2a5-121d-4872-8db7-11999663bc1d.png)


#### 必須拡張機能2：Pylance
Pythonの「Python」拡張機能に続いて、「Pylance」もインストールします。

1. 拡張機能の検索欄に「Pylance」と入力
2. Microsoft製の「Pylance」拡張機能をインストール

**Pylanceとは？**
Pylanceは、Pythonコードを書く際の「優秀なアシスタント」のような拡張機能です：
- **自動補完**：コードを途中まで入力すると、続きを提案してくれる
- **エラー検出**：コードの間違いを即座に赤線で教えてくれる
- **型チェック**：変数の型の間違いを事前に検出
- **定義へジャンプ**：関数や変数の定義元に簡単に移動できる

![2025-06-12 (19).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/d286d9da-0d47-41d1-a8e0-d0e4174f5968.png)

---

## 3. 最初のプロジェクト作成

ここから実際にPythonプロジェクトを作成していきます。「プロジェクト」とは、一つの目的を持ったプログラムのまとまりのことです。今回は練習用の最初のプロジェクトを作成します。

### ステップ1：プロジェクト用フォルダの作成
まず、すべてのPythonプロジェクトを管理する親フォルダを作成します。

1. エクスプローラーを開く
2. Cドライブ直下に「PythonProjects」フォルダを作成
3. その中に最初のプロジェクト用フォルダ「project1」を作成

**フォルダ構造**：
```
C:\
└── PythonProjects\
    └── project1\
```

![2025-06-12 (20).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/b1bde69c-c8db-4fbe-9fe2-e6d0309a6e9d.png)
![2025-06-12 (21).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/939a1edf-7caf-423a-ba8f-a33c597a4aee.png)


### ステップ2：PowerShellでフォルダに移動
PowerShellを開き、作成したフォルダに移動します：

```powershell
cd C:\PythonProjects\project1
```

![2025-06-12 (23).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/886aa642-ef00-4ca6-8315-b0a3d4b33177.png)


### ステップ3：仮想環境の作成
以下のコマンドで仮想環境を作成します：

```powershell
python -m venv venv
```

**解説**：
- `python -m venv`：Pythonの仮想環境作成コマンド
- 最後の`venv`：仮想環境フォルダの名前（慣習的に「venv」を使用）

**作成後のフォルダ構造**：
```
project1/
└── venv/            # 仮想環境フォルダ（自動作成）
    ├── Include/
    ├── Lib/
    ├── Scripts/     # python.exeなどが入っている
    └── pyvenv.cfg
```

**注意**：venvフォルダは仮想環境のシステムファイルなので、この中に自作のPythonファイルを作成しないでください。

![2025-06-12 (25).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/cd285107-3afd-41ef-8525-5c22e70c7f34.png)


### ステップ4：仮想環境の有効化
以下のコマンドで仮想環境を有効化します：

```powershell
.\venv\Scripts\Activate
```

**成功のサイン**：プロンプトの先頭に`(venv)`が表示されます。

![2025-06-12 (31).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/e0350b89-fbdb-43b3-9080-99c0c98c61bc.png)


**もしエラーが出た場合**：
「スクリプトの実行がポリシーで無効」というエラーが出た場合は、以下のコマンドを実行してください：

```powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```

その後、もう一度仮想環境の有効化コマンドを実行します。

---

## 4. VS Codeの設定

### ステップ1：プロジェクトフォルダを開く
1. VS Codeを起動
2. 「ファイル」→「フォルダーを開く」を選択
3. 「C:\PythonProjects\project1」を選択して「フォルダーの選択」をクリック

![2025-06-12 (32).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/218e362b-29e4-4496-9e68-43e594ace776.png)
![2025-06-12 (33).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/acf4adb8-9c64-4850-a5af-048f0a010f38.png)



### Pythonインタープリターとは？

**インタープリター（interpreter）**は、私たちが書いたPythonコードをコンピュータが理解できる形に「通訳」してくれるプログラムです。

#### 身近な例で理解する
インタープリターは「同時通訳者」のようなものです：
- **あなた**：日本語（Pythonコード）で話す
- **インタープリター**：日本語を英語（機械語）に通訳
- **コンピュータ**：英語（機械語）を理解して実行

#### なぜインタープリターを選ぶ必要があるの？
コンピュータには複数のPython環境がインストールされている可能性があります：
- **システム全体のPython**：最初にインストールしたPython
- **仮想環境のPython**：プロジェクトごとに作成したPython

VS Codeに「どのPythonを使うか」を教える必要があるのです。これは、複数の通訳者がいる中から「このプロジェクトではこの通訳者を使ってください」と指定するようなものです。

![2025-06-12 (35).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/d70ab201-0a92-433d-bb69-a0144fdd8ed7.png)


### ステップ2：Pythonインタープリターの選択
1. `Ctrl+Shift+P`でコマンドパレットを開く
2. 「Python: Select Interpreter」と入力して選択
3. 「Enter interpreter path...」を選択
4. 「Find...」を選択
5. `C:\PythonProjects\project1\venv\Scripts\python.exe`を選択

![2025-06-13 (37).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/2febd7fe-1e90-497c-a033-38f67246d160.png)


**なぜvenv内のpython.exeを選ぶの？**
仮想環境内のpython.exeを選ぶことで、そのプロジェクト専用の環境を使用することになります。これにより、他のプロジェクトに影響を与えることなく、必要なライブラリをインストールできます。

![2025-06-12 (34).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/001a07f7-7a09-4c4a-a333-cde884c09162.png)


### ステップ3：仮想環境の動作確認
インタープリターの選択が完了したら、実際にPythonファイルを実行して仮想環境が正しく設定されているか確認します。次の「動作確認」セクションで、check_env.pyを実行することで：

1. 仮想環境が自動的に有効化される
2. 正しいPythonインタープリターが使用されている
3. プロジェクト専用の環境で動作している

ことを確認できます。

![2025-06-13 (4) - コピー.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/00de6397-112e-49dc-b33f-d96573de4bd8.png)


---

## 5. 動作確認

ここでは、Pythonファイルを実行することで仮想環境が正しく設定されているか確認します。

### ステップ1：テストファイルの作成
1. VS Codeの左側のエクスプローラーで「project1」フォルダが選択されていることを確認
2. 「project1」の上で右クリック（または空白部分で右クリック）
3. 「新しいファイル」を選択
4. ファイル名を`check_env.py`にする
5. 以下のコードを入力：

**重要**：check_env.pyは**プロジェクトのルートディレクトリ**（project1フォルダの直下）に作成します。

**ファイル構造**：
```
C:\PythonProjects\
└── project1\                 ← 現在開いているフォルダ
    ├── venv\                 ← 仮想環境フォルダ（自動生成）
    └── check_env.py          ← ここに作成する
```

```python
print("=== Python環境チェック ===")
print("環境の設定状況を確認します...\n")

# 使用中のPythonインタープリターを確認
import sys
import os

print(f"Pythonバージョン: {sys.version.split()[0]}")
print(f"実行ファイルパス: {sys.executable}")

# 仮想環境内かどうかを確認
if "venv" in sys.executable:
    print("\n✅ 仮想環境が正しく設定されています！")
    print("  プロジェクト専用の環境で開発できます。")
    
    # プロジェクト名を表示
    project_path = os.path.dirname(os.path.dirname(sys.executable))
    project_name = os.path.basename(project_path)
    print(f"  プロジェクト名: {project_name}")
else:
    print("\n❌ 仮想環境外で実行されています")
    print("  VS Code左下でPythonインタープリターを確認してください。")
    print("  正しいインタープリター: .\\venv\\Scripts\\python.exe")

print("\n=== チェック完了 ===")
```

![2025-06-13 (1).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/3ef80a00-c839-4bcf-8d38-b87830e46103.png)
![2025-06-13 (6).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/0e345cb8-b7c4-45f5-a971-08bf2b8268f0.png)






### ステップ2：プログラムの実行と仮想環境の確認
**F5キー**を押して実行します（または右上の実行ボタン▶をクリック）。

**重要な確認ポイント**：
1. **ターミナルに`(venv)`が表示される**
   - Pythonファイルの実行時に自動的に仮想環境が有効化されます
   - Windows 11では初回のターミナル起動時には表示されないことがありますが、ファイル実行時には必ず有効化されます

2. **実行結果で「✅ 仮想環境が正しく設定されています！」と表示される**
   - これが表示されれば、正しく仮想環境が使用されています

3. **使用中のPythonパスに`venv`が含まれている**
   - 例：`C:\PythonProjects\project1\venv\Scripts\python.exe`

![2025-06-13 (25)_1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/bea97e63-1a54-41cb-9df3-818effc3f494.png)


**もし「❌ 仮想環境外で実行されています」と表示された場合**：
1. VS Code左下のPythonバージョン表示をクリック
2. `.\venv\Scripts\python.exe (venv)`を選択
3. F5キーで再度実行

### ステップ3：パッケージのインストールテスト
ターミナルで以下のコマンドを実行：

```powershell
pip install requests
```

**解説**：
- `pip`：Pythonのパッケージ管理ツール（Package Installer for Python）
- `requests`：HTTPリクエストを簡単に行えるライブラリ（Webサイトからデータを取得する際などに使用）

**「パッケージ」と「ライブラリ」の違いは？**
実は、Pythonの世界では「パッケージ」と「ライブラリ」はほぼ同じ意味で使われます。厳密には：
- **パッケージ**：配布される形式のこと（pipでインストールするもの）
- **ライブラリ**：機能のまとまり（使う時の呼び方）

例：「requestsパッケージをインストールして、requestsライブラリを使う」

インストール確認用のコードを作成：

**ファイルの作成場所**：プロジェクトのルートディレクトリ（project1フォルダ直下）に作成します。

```python
# test_requests.py
import requests

# GitHubのAPIにアクセスしてテスト
response = requests.get("https://api.github.com")
print(f"ステータスコード: {response.status_code}")

# ステータスコード200は「正常にアクセスできた」という意味
if response.status_code == 200:
    print("✅ requestsライブラリが正常に動作しています！")
    print("   （200 = HTTPリクエストが成功）")
else:
    print(f"❌ エラーが発生しました（コード: {response.status_code}）")
```

**現在のファイル構造**：
```
project1/
├── venv/               # 仮想環境（自動作成されたもの）
├── check_env.py        # 環境確認用ファイル
└── test_requests.py    # 今作成したファイル
```

実行結果
![2025-06-13 (27).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/67e3ee5a-17de-4a9a-9f88-d91a8ab0341b.png)


### ステップ4：Pylanceの動作確認
新しいファイル`test_pylance.py`を作成して、Pylanceの機能を体験してみましょう：

```python
# test_pylance.py
# Pylanceの機能を体験するためのファイル

# 【体験1】自動補完機能
# 下の行で「pri」まで入力してみてください
# Pylanceがprint関数を提案してくれます
# ここに「pri」と入力してTabキーまたはEnterで補完を確認

# 【体験2】型ヒントとエラー検出
def greet(name: str) -> str:
    """名前を受け取って挨拶を返す関数"""
    return f"こんにちは、{name}さん！"

# 正しい使い方
message = greet("太郎")
print(message)

# 【体験3】型エラーの検出
# 下のコメントを外して、数値を渡してみてください
# Pylanceが黄色い波線で警告を表示します
# message2 = greet(123)  # ← このコメントを外してエラーを確認

# 【体験4】メソッドの自動補完
fruits = ["りんご", "バナナ", "オレンジ"]
# 下の行で「fruits.」と入力してみてください
# 使えるメソッド（append, remove, popなど）が表示されます
# fruits.  ← ここでドット(.)を入力して候補を確認

# 【体験5】変数にカーソルを合わせる
# 上の「fruits」変数にマウスカーソルを合わせてみてください
# 変数の型情報（list[str]）が表示されます

print("Pylanceの機能確認が完了しました！")
```

**Pylanceの便利な機能**：
1. **Ctrl + クリック**：関数や変数の定義元にジャンプ
2. **マウスホバー**：関数や変数の詳細情報を表示
3. **F2キー**：変数名の一括変更
4. **Ctrl + Space**：手動で補完候補を表示


![2025-06-13 (28).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/14dd5a02-3234-45e6-ab29-0cc55cfab5d4.png)
- 「pri」と入力した際の自動補完候補の表示

![2025-06-13 (31).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/78bc47b4-cf62-4e16-9286-5ba653a86c79.png)
- greet(123)のコメントを外した際の型エラー警告（黄色い波線）
- 
- ![2025-06-13 (32).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/0808877f-324b-4363-88f2-b6a1a6ecdd84.png)
- fruits.と入力した際のメソッド候補表示


---

## 6. 別プロジェクトの作成方法

2つ目以降のプロジェクトを作成する手順を説明します。基本的には最初のプロジェクトと同じ手順です。

### 方法1：基本手順（最初のプロジェクトと同じ）

1. **新しいプロジェクトフォルダを作成**
   - `C:\PythonProjects`内に新しいフォルダ（例：`project2`）を作成

2. **PowerShellで仮想環境を作成**
   ```powershell
   cd C:\PythonProjects\project2
   python -m venv venv
   ```

3. **VS Codeで開く**
   - 「ファイル」→「フォルダーを開く」→ `project2`を選択

4. **Pythonインタープリターを選択**
   - `Ctrl+Shift+P` → 「Python: Select Interpreter」
   - `.\venv\Scripts\python.exe`を選択

5. **check_env.pyで動作確認**
   - 環境確認用ファイルを作成して実行

### 方法2：VS Code内で完結する方法

VS Codeの統合ターミナルを使って、VS Code内ですべて完結させる方法です。

#### ステップ1：新しいウィンドウでフォルダを作成
1. VS Codeで「ファイル」→「新しいウィンドウ」
2. 「ファイル」→「フォルダーを開く」
3. `C:\PythonProjects`に移動
4. 「新しいフォルダー」ボタンをクリック
5. 「project3」などの名前を付けて「フォルダーの選択」

#### ステップ2：統合ターミナルで仮想環境を作成
1. `Ctrl+`` でターミナルを開く
2. 以下のコマンドを実行：
   ```powershell
   python -m venv venv
   ```

#### ステップ3：Pythonインタープリターを選択
1. しばらく待つと、VS Codeが仮想環境を検出
2. 右下に「新しい仮想環境が検出されました」という通知が表示される場合は「Yes」をクリック
3. 表示されない場合は、`Ctrl+Shift+P` → 「Python: Select Interpreter」→ `.\venv\Scripts\python.exe`を選択

#### ステップ4：動作確認
check_env.pyを作成して、仮想環境が正しく設定されているか確認します。

![2025-06-13 (35).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/34c39b8c-fb07-46f7-bc68-066c167aaad2.png)
![2025-06-13 (36).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/8228de7b-e50d-4ef7-bed2-dd6be5e2a4f0.png)


---

## 7. プロジェクトの切り替え方法

### 方法1：新しいウィンドウで開く（推奨）
異なるプロジェクトは別々のVS Codeウィンドウで開くことを推奨します。

1. 「ファイル」→「新しいウィンドウ」
2. 「ファイル」→「フォルダーを開く」から別のプロジェクトを選択

**メリット**：
- プロジェクトごとに独立した環境
- 複数プロジェクトの同時作業が可能
- 設定の混在を防げる

**［スクリーンショット挿入箇所］**
- 2つのVS Codeウィンドウでproject1とproject2が開かれている状態

### 方法2：ワークスペースを使用（上級者向け）
複数のプロジェクトを1つのウィンドウで管理したい場合：

1. 「ファイル」→「ワークスペースにフォルダーを追加」
2. 追加したいプロジェクトフォルダを選択
3. 各フォルダーで適切なPythonインタープリターを選択

**［スクリーンショット挿入箇所］**
- ワークスペースに複数のフォルダーが追加された状態
- 各フォルダーで異なる仮想環境が選択されている状態

### プロジェクト切り替え時の注意点

#### プロジェクトを開いたら必ず環境を確認
1. **VS Code左下でインタープリターを確認**
2. **check_env.pyを実行して仮想環境を確認**
   - 各プロジェクトにcheck_env.pyを保存しておくと便利
   - 「✅ 仮想環境が正しく設定されています！」の表示を確認

#### ターミナルでの仮想環境切り替え（手動で行う場合）
現在の仮想環境を無効化してから、新しい仮想環境を有効化：

```powershell
# 現在の仮想環境を無効化
deactivate

# 別のプロジェクトに移動
cd C:\PythonProjects\project2

# 新しい仮想環境を有効化
.\venv\Scripts\Activate
```


---

## 8. トラブルシューティング

### よくある問題と解決方法

#### Q1: PowerShellで「スクリプトの実行がポリシーで無効」エラーが出る
**解決方法**：管理者権限でPowerShellを開き、以下を実行：

```powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```

「Y」を入力してEnterを押します。


#### Q2: 「python」コマンドが認識されない
**解決方法**：
1. `python`の代わりに`py`を試す
2. それでもダメな場合は、Pythonを再インストール（必ず「Add Python to PATH」にチェック）

```powershell
# 代替コマンド
py --version
py -m venv venv
```

#### Q3: VS Codeで仮想環境が認識されない
**解決方法**：
1. VS Codeを完全に終了（すべてのウィンドウを閉じる）
2. プロジェクトフォルダを再度開く
3. 手動でPythonインタープリターを選択

**インタープリターが見つからない場合**：
- VS Codeの左下を確認（Pythonバージョンが表示されているか）
- 表示されていない場合は、その部分をクリックして手動選択
- 「Reload Window」（ウィンドウの再読み込み）を試す

#### Q4: pip installでエラーが出る
**解決方法**：pipをアップグレード

```powershell
python -m pip install --upgrade pip
```

#### Q5: Pylanceが正しく動作しない
**解決方法**：
1. Python拡張機能が正しくインストールされているか確認
2. VS Codeを再起動
3. 設定でPylanceが有効になっているか確認
   - 「ファイル」→「基本設定」→「設定」
   - 「python.languageServer」で検索
   - 「Pylance」が選択されているか確認


---

## プロジェクト管理のベストプラクティス

### インタープリター管理の注意点
**プロジェクトごとに正しいインタープリターを使用しているか確認する習慣をつけましょう：**

1. **VS Code左下の表示を確認**
   - `Python 3.x.x ('venv': venv)`のように表示されていればOK
   - プロジェクト名と一致しているか確認

2. **check_env.pyで実際の動作を確認（最も確実）**
   - プロジェクトを開いたら、check_env.pyを実行して環境を確認
   - 「✅ 仮想環境が正しく設定されています！」の表示を確認
   - この方法が最も確実で、環境による差異の影響を受けません

3. **定期的な確認コマンド**
   ```powershell
   # 現在使用中のPythonを確認
   where python
   
   # Pythonのバージョンを確認
   python --version
   ```

**Windows 11での注意点**：
- ターミナルを開いただけでは`(venv)`が表示されないことがあります
- Pythonファイルを実行すると自動的に仮想環境が有効化されます
- 開発作業に支障はありませんので、check_env.pyでの確認を習慣づけましょう

![2025-06-13 (25)_1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/515272/a722b45e-8542-4c2b-bb92-78823f5d34cb.png)


### フォルダ構造の推奨例
プロジェクトごとに分かりやすい名前を付けて管理しましょう：

```
C:\PythonProjects\
├── webdev_project/          # Webアプリ開発プロジェクト
│   ├── venv/               # このプロジェクト専用の仮想環境
│   ├── check_env.py        # 環境確認用ファイル
│   ├── app.py              # メインのプログラムファイル
│   ├── requirements.txt    # 使用しているライブラリ一覧
│   └── static/             # 画像やCSSなどの静的ファイル用
├── data_analysis/           # データ分析プロジェクト
│   ├── venv/               # このプロジェクト専用の仮想環境
│   ├── check_env.py        # 環境確認用ファイル
│   ├── analysis.py         # 分析用のプログラム
│   ├── requirements.txt    # pandas等の分析ライブラリ一覧
│   └── data/               # CSVファイルなどのデータ用
└── automation/              # 自動化スクリプトプロジェクト
    ├── venv/               # このプロジェクト専用の仮想環境
    ├── check_env.py        # 環境確認用ファイル
    ├── main.py             # 自動化のメインプログラム
    ├── requirements.txt    # selenium等の自動化ライブラリ一覧
    └── utils/              # 補助的な関数を入れるフォルダ
```

### ファイル保存場所のガイドライン

**基本ルール**：すべての自作Pythonファイル（.py）は**プロジェクトフォルダの直下**に保存します。

#### 1. 小規模プロジェクト（ファイル数が10個以下）
```
project1/
├── venv/                    # 触らない（仮想環境）
├── check_env.py             # 環境確認用
├── main.py                  # メインプログラム
├── test.py                  # テスト用
├── test_requests.py         # ライブラリ動作確認用
├── test_pylance.py          # Pylance機能確認用
└── utils.py                 # 便利な関数など
```

#### 2. 中規模以上のプロジェクト（ファイル数が多い場合）
```
project1/
├── venv/                    # 触らない（仮想環境）
├── check_env.py             # 環境確認用（ルートに置く）
├── main.py                  # メインプログラム（ルートに置く）
├── data/                    # データファイル用フォルダ
│   └── sample.csv
├── src/                     # ソースコード用フォルダ
│   ├── database.py
│   └── calculations.py
└── tests/                   # テストファイル用フォルダ
    └── test_main.py
```

**ポイント**：
- **venvフォルダ内には絶対にファイルを作成しない**
- プロジェクト名は内容が分かりやすい名前にする
- check_env.pyは必ずプロジェクトのルートに置く
- ファイル名は機能が分かりやすい名前を付ける（例：`calculate_tax.py`、`send_email.py`）

### requirements.txtの活用
プロジェクトで使用しているパッケージを記録：

```powershell
# 現在の環境のパッケージ一覧を保存
pip freeze > requirements.txt

# 別の環境で同じパッケージをインストール
pip install -r requirements.txt
```

**［スクリーンショット挿入箇所］**
- requirements.txtの内容例
- pip install -r requirements.txtの実行画面

### .gitignoreファイルの作成
Gitを使用する場合、仮想環境フォルダは除外：

```
# .gitignore
venv/
__pycache__/
*.pyc
.env
.vscode/
```

### Pylanceの設定（オプション）
プロジェクトごとにPylanceの設定をカスタマイズしたい場合は、`.vscode/settings.json`を作成：

```json
{
    "python.analysis.typeCheckingMode": "basic",
    "python.analysis.autoImportCompletions": true,
    "python.analysis.autoSearchPaths": true
}
```

**設定の説明**：
- `typeCheckingMode`：型チェックの厳密さ（"off", "basic", "strict"）
- `autoImportCompletions`：自動インポート提案
- `autoSearchPaths`：パスの自動検索

---

## まとめ

これでWindows環境でのPython開発環境構築は完了です！

### 重要なポイントの復習
1. **プロジェクトごとに仮想環境を作成**する
2. **VS Codeでは適切なインタープリターを選択**する（仮想環境内のpython.exeを使用）
3. **check_env.pyで環境を確認**する習慣をつける（最も確実な方法）
4. **Pylanceで効率的な開発**を実現（自動補完、エラー検出、型チェック）
5. **プロジェクトは別々のウィンドウで開く**のが推奨
6. **Pythonファイルはプロジェクトフォルダ直下に保存**（venvフォルダには触らない）

### 次のステップ
1. **基本的なPythonの学習**：変数、条件分岐、ループなど
   - Pylanceの自動補完機能を活用して効率的に学習
2. **生成AIで作成したコードを試す**
   - ChatGPTやClaude等で生成したPythonコードを実行
   - エラーが出た場合の対処法を学ぶ
   - AIと対話しながらコードを改善する方法
3. **ライブラリの活用**：
   - NumPy（数値計算）
   - Pandas（データ分析）
   - Flask/Django（Web開発）
   - Selenium（ブラウザ自動化）
4. **プロジェクト構造の整理**：
   - ファイル数が増えたらフォルダで整理
   - モジュール分割の学習
5. **バージョン管理**：Gitの導入
6. **型ヒントの活用**：Pylanceの機能を最大限に活かすための記述方法

### 参考リンク
- [Python公式ドキュメント（日本語）](https://docs.python.org/ja/3/)
- [VS Code Python拡張機能ドキュメント](https://code.visualstudio.com/docs/python/python-tutorial)
- [Pylance公式ドキュメント](https://github.com/microsoft/pylance-release)
- [Python Package Index (PyPI)](https://pypi.org/) - Pythonライブラリの検索
- [Real Python](https://realpython.com/) - 詳細なPythonチュートリアル（英語）
- [Python.jp](https://www.python.jp/) - 日本のPythonユーザーコミュニティ

---

## 用語集（初心者向け）

### 基本用語の解説

**Python（パイソン）**
- プログラミング言語の一つ。人間が理解しやすい形でコンピュータへの指示を書ける

**プロジェクト（Project）**
- 一つの目的を持ったプログラムのまとまり
- 例：「家計簿アプリ」「Webサイト」「データ分析ツール」など

**プロジェクトフォルダ/ルートディレクトリ**
- プロジェクトの一番上の階層のフォルダ
- 例：`C:\PythonProjects\project1\`の「project1」がルートディレクトリ
- 自作のPythonファイルはここに保存する

**ライブラリ（Library）**
- 他の人が作った便利な「道具箱」
- 特定の機能をまとめたプログラムの部品
- 例：requests（Web通信）、pandas（データ分析）、pygame（ゲーム作成）

**バージョン（Version）**
- ソフトウェアの「版」のこと
- 例：Python 3.11.0、pandas 2.0.0など
- 数字が大きいほど新しい

**インタープリター（Interpreter）**
- Pythonコードを機械語に「通訳」するプログラム
- 例：日本語→英語の同時通訳者のような役割

**仮想環境（Virtual Environment）**
- プロジェクトごとの独立したPython実行環境
- 例：プロジェクトごとの専用の部屋

**IDE（統合開発環境）**
- プログラムを書くための高機能なエディタ
- VS Codeもその一つ

**Pylance（パイランス）**
- VS CodeでPythonを書く際の「優秀なアシスタント」
- コードの自動補完、エラー検出、型チェックなどを提供
- Microsoft製の拡張機能

**pip（ピップ）**
- Pythonのパッケージ（ライブラリ）管理ツール
- Package Installer for Pythonの略

**パッケージ/ライブラリ**
- 他の人が作った便利な機能をまとめたもの
- 例：requestsは「Webサイトからデータを取得する」機能を提供

**PATH（パス）**
- コンピュータがプログラムを探す場所のリスト
- 「Add Python to PATH」は「Pythonをどこからでも使えるようにする」という意味

---

## クイックリファレンス

### プロジェクトのファイル構造
```
project_name/           # プロジェクトフォルダ（ルートディレクトリ）
├── venv/              # 仮想環境（触らない）
├── check_env.py       # 環境確認用（必須）
├── main.py            # メインプログラム
├── requirements.txt   # ライブラリ一覧
└── その他の.pyファイル  # すべてルートに配置
```

### VS Codeの便利なショートカットキー
```
Ctrl + Space      : 手動で補完候補を表示（Pylance）
Ctrl + クリック   : 定義元へジャンプ
F2               : 変数名の一括変更
Ctrl + /         : コメントアウト/解除
Ctrl + Shift + P : コマンドパレット
Ctrl + `         : ターミナルの表示/非表示
F5               : デバッグ実行
Shift + F5       : デバッグ停止
```

### 仮想環境の基本コマンド
```powershell
# 仮想環境の作成
python -m venv venv

# 仮想環境の有効化
.\venv\Scripts\Activate

# 仮想環境の無効化
deactivate

# 仮想環境の削除（フォルダごと削除）
Remove-Item -Recurse -Force venv
```

### パッケージ管理コマンド
```powershell
# パッケージのインストール
pip install パッケージ名

# 特定バージョンのインストール
pip install パッケージ名==バージョン番号

# パッケージのアップグレード
pip install --upgrade パッケージ名

# インストール済みパッケージの確認
pip list

# パッケージの詳細情報
pip show パッケージ名

# パッケージのアンインストール
pip uninstall パッケージ名

# requirements.txtの作成
pip freeze > requirements.txt

# requirements.txtからインストール
pip install -r requirements.txt
```

Happy Coding! 🐍

----解説ｺｺﾏﾃﾞ----

＊Mac版は需要があれば制作しようかな・・・