Pythonの環境設定（Windows + VSCodeで動かすまで）

投稿日：2026-01-09

音声

※ AI音声で読み上げます

ゴール：VSCodeでPythonが1本動く状態にする
Python本体のインストールと確認（PATH／python --version）
VSCodeの準備（Python拡張・フォルダを開く）
Hello Worldを実行（hello.py作成→実行）
つまずきポイントTOP3（pythonが見つからない／インタプリタ違い／未保存）
注意（ここだけ）
要約

ゴール：VSCodeでPythonが1本動く状態にする

今回できるようになることとして、Windows上のVSCodeで.pyファイルを作り、ターミナルまたは実行ボタンで動かせる状態にします。

まずはPython実行環境をインストールしてPATHに入れ、VSCode側でPython拡張を入れ、簡単なスクリプトを作って実行まで確認します。

仮想環境（venv）は最初は必須ではありませんが、プロジェクトが増えたら使う準備だけしておくとよいです。

最初の流れをつかむことで、以後の学習やパッケージ導入（pip）にスムーズにつながります。

最小コード：

import sys

def greet(name):
    return f"Hello, {name}!"

if __name__ == "__main__":
    print(greet("World"))
    print("Python version:", sys.version.split()[0])
    assert "Hello" in greet("Test")

貼り付け場所：hello.py（プロジェクト用のフォルダを作り、その中に保存します。拡張子は必ず .py にします。JupyterではなくVSCodeのエディタで保存してください。）

Python本体のインストールと確認（PATH／python --version）

公式サイト（python.org）からWindows用のインストーラをダウンロードし、「Add Python to PATH」のチェックを入れてからインストールします。

これを入れておくとコマンドプロンプトやPowerShell、VSCodeの統合ターミナルで python と打つだけで実行できます。

インストール後はコマンドプロンプトかPowerShellを開き、以下のコマンドで確認します。

python --version
where python

実行方法は、コマンドプロンプト（cmd）またはPowerShell、もしくはVSCodeのターミナルで上のコマンドを打つことです。

バージョンが表示されればインストール成功です。

where python で複数パスが出る場合は、どの実行ファイルが使われているかを把握できます。

PATHを付け忘れたときは、インストーラを再実行するか、環境変数の編集で追加します。

VSCodeの準備（Python拡張・フォルダを開く）

VSCodeを開いたら左の拡張機能（Extensions）で「Python」（Microsoft製）を検索してインストールします。

※拡張機能「Japanese Language Pack for Visual Studio Code」も入れて再起動するとVSCode本体のメニューや設定画面が日本語化します。

単一ファイルを開くより、フォルダごと「フォルダを開く」でプロジェクトを開いた方が設定や仮想環境の認識が安定します。

画面右下に表示されるPythonインタプリタ名をクリックすると使用するPython本体（インタプリタ）を選べます。ここで仮想環境（venv）やシステムPythonを選べますので、プロジェクトごとに切り替えて使います。

使い分けの基準として、小さなスクリプトや学習初期はシステムPythonでも問題ありませんが、実プロジェクトや外部パッケージを複数扱うときは仮想環境（venv）を使うと依存関係が分離され安全です。データ解析や説明用の短いトライはJupyterが便利で、スクリプト化して配布するなら .py にしてVSCodeで管理します。

Hello Worldを実行（hello.py作成→実行）

プロジェクトフォルダに hello.py を作成し、先ほどの最小コード（greet関数など）を貼り付けます。保存は必ず Ctrl+S（またはファイルメニュー）で行ってください。未保存のまま実行すると古い内容が走ることがあります。

保存後、VSCodeの上部にある▶（実行）ボタンを押すか、統合ターミナルで以下のように実行します。

python hello.py

確認方法として、実行するとターミナルに Hello, World! と表示され、続けて Python のバージョンが出ます。assertが失敗していなければエラーは出ません。表示が期待どおりであれば正しく動いています。もしエラーが出たらエラーメッセージを読み、ファイルの保存漏れやインタプリタの指定ミスを疑います。

つまずきポイントTOP3（pythonが見つからない／インタプリタ違い／未保存）

まず多いのは「pythonが見つからない」エラーで、これはインストール時にPATHを通していないか、複数のPythonが入っていて参照先が違う場合に起きます。

解決策はインストーラの再実行で「Add Python to PATH」をチェックするか、環境変数にパスを追加することです。

次に「インタプリタ違い」で、VSCodeの右下に表示されるインタプリタを誤って古いものや別バージョンにしているケースがあります。

ここは必ずプロジェクトに合ったPythonを選び直してください。

最後に「未保存」です。エディタで編集したものを保存せずにターミナルで実行すると、古い内容が実行されて混乱します。

保存を習慣化してください。

よくあるミスは、VSCodeでファイルを保存していないために古いコードが実行されることが最も頻繁である点です。

直し方は、編集後に必ず保存（Ctrl+S）するか、設定で実行前に自動保存を有効にすることです。

注意（ここだけ）

ファイルを消す前に、別名で保存（例：hello_backup.py）しておくと安心です。

要約

まずはpython.orgからインストールし、「Add Python to PATH」を有効にして、コマンドで python --version を確認します。
VSCodeにPython拡張を入れ、フォルダを開いて右下のインタプリタを正しいものに設定します。
hello.py を作り、保存してからターミナルで python hello.py を実行すると動作確認できます。
よくある問題はPATH未設定、VSCodeのインタプリタ選択ミス、ファイル未保存の3点で、順に対処すれば解決します。
初期はシステムPythonで学び、プロジェクトが増えたら仮想環境（venv）を使う基準で切り替えると管理が楽になります。

音声