Lesson3 / 6

Pythonの開発環境を準備しよう（Windows編）

PyStarUpでは、レッスンページやプレイグラウンドのエディタでPythonを実行できる環境がすでに用意されています。 そのため、今すぐ学習を始めたい場合は、環境構築をしなくてもこのサイト上でPythonを学べます。

このレッスンは、ローカル環境（自分のPC）でもPythonを使えるようにしたい人向けの内容です。

すぐに学習を始めたい方はこのレッスンを飛ばしてください。

目次

このレッスンで学ぶこと

  • WindowsにPythonをインストールする方法
  • インストールが正しくできたか確認する方法
  • テキストエディタ（VS Code）のインストール
  • 開発環境の基本的な使い方

なぜ開発環境の準備が必要なのか？

Pythonプログラムを書いて実行するには、まずパソコンに開発環境を整える必要があります。

開発環境とは: プログラムを書いて、実行するために必要なソフトウェアのセットです。

料理に例えるなら、キッチンの準備のようなものです。料理を始める前に、包丁やまな板、コンロを用意するように、プログラミングを始める前にも準備が必要です。

💡 豆知識: Pythonは最初からMacやLinuxにはインストールされていることが多いですが、Windowsには通常入っていません。そのため、自分でインストールする必要があります。

必要なもの

このレッスンで準備するもの：

  1. Python本体: プログラムを実行するソフトウェア
  2. テキストエディタ: プログラムを書くソフトウェア（VS Codeを推奨）

Python本体のインストール

ステップ1: Pythonの公式サイトにアクセス

Webブラウザを開いて、以下のURLにアクセスします：

https://www.python.org/

ステップ2: ダウンロードページへ移動

  1. トップページの「Downloads」をクリック
  2. 「Download for Windows」の下にある黄色いボタン「Download Python 3.x.x」をクリック

注意: 数字（3.x.x）は常に最新バージョンが表示されます。特に理由がなければ、最新版をダウンロードしましょう。

ステップ3: インストーラーを実行

  1. ダウンロードしたファイル（python-3.x.x-amd64.exe）をダブルクリック
  2. インストーラーが起動します

重要: 必ずチェックを入れる！

インストーラーの最初の画面で、以下の項目に必ずチェックを入れてください：

☑ Add python.exe to PATH

このチェックを忘れると、インストール後に手動でパスを環境変数へ設定する必要があり、初心者がつまづくポイントになります。

ステップ4: インストール実行

チェックを入れたら、「Install Now」をクリックします。

インストール中の画面:

Installing:
- Python interpreter
- pip (package installer)
- Documentation
...

数分待つと、「Setup was successful（インストール成功）」と表示されます。

「Close」をクリックして完了！

ステップ5: インストール確認

正しくインストールできたか確認しましょう。

確認方法:

  1. スタートメニューを開く
  2. 検索ボックスに「cmd」と入力
  3. 「コマンドプロンプト」が表示されるのでクリック

黒い画面（コマンドプロンプト）が開きます。

ステップ6: Pythonのバージョン確認

コマンドプロンプトで以下を入力して、Enterキーを押します：

Shell
python --version

正しくインストールできている場合:

Python 3.11.0

のように、バージョン番号が表示されます。

エラーが出る場合:

'python' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。

このエラーが出た場合は、「Add python.exe to PATH」のチェックを忘れた可能性があります。一度Pythonをアンインストールして、再度インストールしてください。

ステップ7: pipの確認

pip（ピップ）は、Pythonのライブラリをインストールするためのツールです。Pythonと一緒に自動でインストールされます。

コマンドプロンプトで以下を入力：

Shell
pip --version

正しくインストールできている場合:

pip 23.0.1 from C:\Users\...\Python\Python311\site-packages\pip (python 3.11)

のように表示されます。

テキストエディタのインストール（VS Code）

Pythonのコードを書くには、テキストエディタが必要です。

推奨: Visual Studio Code（VS Code）

VS Codeは無料で、初心者にも使いやすく、プロも使う高機能なエディタです。

ステップ1: VS Codeのダウンロード

以下のURLにアクセス：

https://code.visualstudio.com/

トップページの「Download for Windows」をクリック

ステップ2: インストーラーを実行

  1. ダウンロードしたファイル（VSCodeUserSetup-x64-x.x.x.exe）をダブルクリック
  2. 利用規約に同意して「次へ」

推奨設定:

以下の項目にチェックを入れることをおすすめします：

☑ デスクトップ上にアイコンを作成する
☑ PATHへの追加（再起動後に使用可能）
☑ Codeで開くアクションをWindowsエクスプローラーのファイルコンテキストメニューに追加する
☑ Codeで開くアクションをWindowsエクスプローラーのディレクトリコンテキストメニューに追加する

「次へ」→「インストール」をクリックして完了を待ちます。

ステップ3: Python拡張機能のインストール

VS CodeでPythonを快適に使うために、拡張機能をインストールします。

  1. VS Codeを起動
  2. 左側のメニューから「拡張機能」アイコン（四角が4つのアイコン）をクリック
  3. 検索ボックスに「Python」と入力
  4. 「Python」（Microsoftが提供）を見つけて「Install」をクリック

インストール完了の確認: 「Install」ボタンが「Uninstall」に変われば成功です。

ステップ4: 日本語化（オプション）

VS Codeを日本語で使いたい場合：

  1. 拡張機能の検索ボックスに「Japanese」と入力
  2. 「Japanese Language Pack for Visual Studio Code」を見つけてインストール
  3. VS Codeを再起動

メニューが日本語になります。

開発環境の動作確認

テストプログラムを書いてみよう

実際にプログラムを書いて実行してみましょう。

ステップ1: フォルダを作成

  1. ドキュメントフォルダに「python_practice」という名前のフォルダを作成
    • 場所: C:\Users\[ユーザー名]\Documents\python_practice

ステップ2: VS Codeでフォルダを開く

  1. VS Codeを起動
  2. 「ファイル」→「フォルダーを開く」
  3. 先ほど作った「python_practice」フォルダを選択

ステップ3: 新しいファイルを作成

  1. 左側のエクスプローラーで「新しいファイル」アイコンをクリック
  2. ファイル名を「hello.py」として保存

ステップ4: コードを書く

hello.py に以下を入力：

Python
print("Hello, Python!")
print("開発環境のセットアップ成功！")

保存: Ctrl + S で保存

プログラムを実行

方法1: VS Code内で実行（推奨）

  1. hello.py を開いた状態で、右上の「▶（再生ボタン）」をクリック
  2. 下部のターミナルに結果が表示される

実行結果:

Hello, Python!
開発環境のセットアップ成功！

方法2: コマンドプロンプトで実行

  1. コマンドプロンプトを開く
  2. フォルダに移動： 
    Shell
    cd C:\Users\[ユーザー名]\Documents\python_practice
  3. 実行： 
    Shell
    python hello.py

実行結果:

Hello, Python!
開発環境のセットアップ成功！

この結果が表示されれば、開発環境のセットアップ完了です！

よくある問題と解決方法

問題1: 「pythonコマンドが見つかりません」エラー

エラーメッセージ:

'python' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。

原因: 「Add python.exe to PATH」のチェックを忘れた

解決方法:

  1. Pythonをアンインストール（設定→アプリから）
  2. 再度インストールして、必ず「Add python.exe to PATH」にチェック

問題2: Microsoft Storeが開いてしまう

Windowsで python と入力すると、Microsoft Storeが開いてしまう場合があります。

解決方法:

  1. 「設定」を開く
  2. 「アプリ」→「アプリと機能」
  3. 「アプリ実行エイリアス」をクリック
  4. 「アプリインストーラー python.exe」と「アプリインストーラー python3.exe」をオフにする

問題3: VS Codeでプログラムが実行できない

症状: 再生ボタンを押しても何も起こらない

解決方法:

  1. Python拡張機能がインストールされているか確認
  2. VS Codeを再起動
  3. ファイルを .py の拡張子で保存しているか確認

問題4: 文字化けする

症状: 日本語が正しく表示されない

解決方法:

ファイルの先頭に以下を追加：

Python
# -*- coding: utf-8 -*-

また、VS Codeの設定で「UTF-8」が選ばれているか確認してください。

問題5: インストール時に権限エラー

症状: 「管理者権限が必要です」と表示される

解決方法:

  1. インストーラーを右クリック
  2. 「管理者として実行」を選択
  3. 「はい」をクリックして続行

練習問題

問題1（基礎）⭐☆☆

Pythonが正しくインストールされているか確認するコマンドを書いてください。

💡 ヒント

コマンドプロンプトで入力するコマンドです。バージョンを確認するコマンドを思い出しましょう。

✅ 解答例 
Shell
python --version

実行結果例:

Python 3.11.0

解説: --version オプションを付けることで、インストールされているPythonのバージョンを確認できます。このコマンドでバージョンが表示されれば、Pythonが正しくインストールされています。

問題2（基礎）⭐☆☆

以下のプログラムを test.py という名前で保存して実行してください：

Python
print("私の名前は〇〇です")
print("Pythonの学習を始めました")

（〇〇の部分は自分の名前に変えてください）

💡 ヒント
  1. VS Codeで新しいファイルを作成
  2. ファイル名を test.py にする
  3. コードを入力して保存（Ctrl+S）
  4. 右上の▶ボタンで実行
✅ 解答例

ファイル名: test.py

コード:

Python
print("私の名前は太郎です")
print("Pythonの学習を始めました")

実行結果:

私の名前は太郎です
Pythonの学習を始めました

解説: これが実行できれば、開発環境が正しくセットアップされています。今後のレッスンでは、このように「コードを書く→保存→実行」という流れを繰り返していきます。

問題3（応用）⭐⭐☆

コマンドプロンプトを使って、以下の手順を実行してください：

  1. Documentsフォルダに移動
  2. python_testという名前のフォルダを作成
  3. そのフォルダに移動
  4. greeting.pyというファイルを作成して、「こんにちは」と表示するプログラムを書く
  5. 実行する
💡 ヒント

使うコマンド:

  • フォルダ移動: cd
  • フォルダ作成: mkdir
  • ファイル作成: テキストエディタで作成
  • 実行: python greeting.py
✅ 解答例

コマンドプロンプトでの操作:

Shell
# Documentsフォルダに移動
cd C:\Users\[ユーザー名]\Documents

# フォルダ作成
mkdir python_test

# 作成したフォルダに移動
cd python_test

テキストエディタ（VS Codeやメモ帳）で greeting.py を作成:

Python
print("こんにちは")

ファイルを python_test フォルダに保存します。

実行:

Shell
python greeting.py

実行結果:

こんにちは

解説: この問題では、コマンドプロンプトの基本操作を練習しました。フォルダの作成・移動ができるようになると、ファイル管理がスムーズになります。

まとめ

このレッスンでは、WindowsでPythonを使うための開発環境を構築しました。

  • Python本体のインストール手順と、確認コマンドの使い方を学びました。
  • インストール時の「Add python.exe to PATH」が重要な設定であることを理解しました。
  • VS CodeとPython拡張機能を導入し、編集と実行の基本操作を確認しました。
  • python --version などのコマンドで環境状態を確認する方法を身につけました。
  • 代表的なエラーの原因と対処を整理し、初期トラブルに対応できる状態になりました。