Python環境構築ベストプラクティス（非プログラマ向け・Windows編）

ミカイ｜プログラミング×創作

2026年4月6日 09:35

はじめに：環境構築で詰まるのは「方法が多すぎる」から

「環境構築」とは、Pythonスクリプトを動かすために必要なソフトを揃えて、動く状態にする作業のことです。プログラミングを始める最初の関門です。

Pythonを始めようとして、最初の壁にぶつかる人が多くいます。「Python インストール」で検索して調べると方法がいくつも出てきて、どれが正しいのかわからない。

python.org から直接インストール
winget でインストール
Anaconda でインストール
pyenv-win でインストール

どれが正しいのでしょうか。結論から言うと、非プログラマがPythonスクリプトを動かすなら、winget でインストールするのが最もシンプルで安定します。

各方法に長所・短所はありますが、この記事では「迷わない・詰まらない」を最優先に、著者が実際に使っている方法を紹介します。

手順どおりにコピペで進めれば、Pythonのことを何も知らなくても環境構築を完了できます。 コマンドの意味は都度説明しますが、意味がわからなくても手順は進みます。まず動かすことを優先してください。

この記事は Windows 11 を前提としています（Windows 10 の方は付録を参照してください）。

使うツールは以下の2つです。

winget：Windows 標準搭載の「コマンドラインで使えるアプリストア」
VS Code：スクリプトの確認・編集と実行をまとめて行えるエディタ（無料）

この2つを入れれば、Pythonスクリプトをすぐに動かせる状態になります。

Pythonインストールの途中で生じる「Windows特有の詰まりどころ」も、すべて解決方法を提示します。この記事は「非プログラマ向け・Windows」の決定版を目指しています。疑問点がある方は、ぜひコメントから質問してください。

この記事はWindows専用です
Mac の方は別の手順が必要です。この記事の対象外となります。

Mac の方はこちらから

なぜ Python なのか

Pythonが強力な理由のひとつは、パッケージの豊富さです。たとえばQRコードを生成する機能を自力で実装しようとすると、何千行ものコードが必要です。しかしPythonでは、`pip install qrcode` コマンドでパッケージをインストールして、`import qrcode` の1行でその機能をまるごと追加できます。

`pip`（ピップ）はPythonのパッケージ管理ツールで、PyPI（pypi.org）という公開リポジトリからパッケージを検索・インストールできます。現在50万件以上のパッケージが公開されており、画像処理・データ分析・Web操作・音声処理など、あらゆる用途のパッケージが揃っています。このエコシステムの充実がPythonを選ぶ大きな理由です。

コラム｜ライブラリ・パッケージ・モジュールの違い
この3つは似た意味で使われますが、文脈によって使い分けがあります。
パッケージ：`pip install` でインストールする単位。「外から持ってくる」操作の文脈で使います（例：「パッケージをインストールする」）
ライブラリ：パッケージやモジュールを含む広い総称。「機能・ツール」として紹介する文脈で使います（例：「画像処理ライブラリ」「ライブラリが使えない」）
モジュール：`.py` ファイル1つの単位。`import` で読み込む対象（例：`import qrcode`）
日常的な会話では「ライブラリ」と「パッケージ」はほぼ同義として使われます。厳密な区別より、文脈に合った言葉を選ぶ感覚で大丈夫です。

全体の流れ

手順は5ステップです。

PowerShell を起動する
Python・VS Code をインストールする
Python 拡張機能をインストールする
仮想環境を作る
Pythonを動かしてみる

順番に進めていきましょう。

Step 1：PowerShell を起動する

PowerShell は、Windows に最初から入っているアプリです。コマンド（文字）でコンピュータに命令を出す画面で、環境構築の操作はここから行います。

`Windows キー` を押して、「powershell」と入力します。「Windows PowerShell」が候補に表示されたら、クリックして起動します。

青い（または黒い）画面のウィンドウが開けばOKです。

コラム｜PowerShell って怖い？
PowerShell を怖いと感じるのは正しい感覚です。操作を誤ると、データが消えて復旧できない場合があります。特に `del` や `rd` から始まるコマンドは削除コマンドですから注意してください。
ただし、この記事に載っているコマンドはすべて安全を確認しています。コマンドは必ずコピペで実行してください。手入力によるタイプミスが一番危険です。不安なコマンドは、ChatGPTなどに「このコマンドは何をするものですか」と確認するクセをつけておくとよいでしょう。

Step 2：Python・VS Code をインストールする

winget（ウィンゲット）は、Windows 11 に標準搭載されているパッケージマネージャーです。「コマンドラインで使えるアプリストア」と思ってください。これを使って Python と VS Code をまとめてインストールします。

2-1. Python・VS Code をインストールする

以下の2行を PowerShell に貼り付けて Enter を押します。1行ずつ実行してください。

winget install -e --id Python.Python.3.12 --source winget
winget install -e --id Microsoft.VisualStudioCode --source winget

`-e`：完全一致（exact）でパッケージを指定する。これがないと似た名前のパッケージが複数ヒットしてエラーになる
`--id`：パッケージの正式なIDを指定する
`--source winget`：Microsoft Store と混在してエラーになるのを防ぐため、コミュニティリポジトリを明示する

筆者の環境では Pythonインストールでエラーになりましたが、　PowerShellを再起動してやり直したら正しく動作するようになりました。もしエラーになっても慌てず、もう一度チャレンジしてみてください。

`Python.Python.3.12` とバージョンを指定しているのには理由があります。バージョンを省略すると、2025年4月時点では最新版の Python 3.14 がインストールされます。しかし、PyTorch や TensorFlow などの機械学習系ライブラリが 3.14 にまだ対応しておらず、インストールできません。機械学習系のライブラリは、直接使わない場合でも多くのライブラリが内部で前提としているため、対応していないと思わぬところで詰まります。

個人的な見解として、Python は最新版より「二つ前」のバージョンを使うことをおすすめします。 3.12 であれば主要なライブラリがすべて安定してサポートしており、初心者が環境構築で詰まるリスクが大幅に減ります。

コラム｜Pythonのバージョン — 最新版（3.14） vs 枯れた安定版（3.12）
Pythonのバージョンは「3.12.3」のように3つの数字で表されます。真ん中の数字（12）が機能追加のバージョンで、毎年10月に1つ上がります。末尾の数字（3）はバグ修正です。
Pythonには、2系から3系へのアップデートで互換性が完全に失われたという過去があります。当時、2系で書かれた膨大なコードが3系では動かなくなり、移行に何年もかかりました。この経験はPythonコミュニティに深く刻まれています。3系になってからは互換性が壊れることはなくなりましたが、毎年の機能追加に対してライブラリ側の対応が追いつかないという問題は残っています。新しいバージョンが出ても、主要なライブラリが対応するまでに数ヶ月かかるのが通例です。
つまり、Pythonのバージョン選びは「最新の機能を使いたいか」「できるだけ多くのライブラリとの互換性をとるか」のトレードオフです。最新の 3.14 はライブラリ対応がまだ不十分で、環境構築の時点でつまずくリスクがあります。一方 3.12 はリリースから十分な時間が経ち、ほぼすべての主要ライブラリが対応済みです。初心者にとっては、最新機能のメリットよりも、ライブラリが確実に動くことのほうがはるかに重要です。迷ったら、枯れた安定版を選んでおけば間違いありません。

インストールには数分かかります。途中で「このアプリがデバイスに変更を加えることを許可しますか？」と表示されたら「はい」を押してください。

2-2. インストールを確認する

PowerShell を一度閉じて、再度起動してください。 インストール後に PythonのPATH（コマンドの検索場所）が更新されるため、再起動が必要です。

再起動後、以下を入力して Enter を押します。

python --version

「Python 3.12.x」のようなバージョン番号が表示されれば成功です。

コラム｜なぜ Anaconda は使わないのか
Anaconda は機械学習・データサイエンス向けの大規模なツール一式です。自動化スクリプトを動かすだけなら不要なものが多く、ライセンスや容量の面でも非プログラマの用途には向きません。この記事では扱いません。

Step 3：Python 拡張機能をインストールする

VS Code を起動します。スタートメニューまたはデスクトップのショートカットから「Visual Studio Code」を開いてください。

「Get started with VS Code」画面では、「AIを使うか」「テーマを選ぶか」など聞かれますが、これらは後からいつでも変更できます。今は**Mark Done（完了）**を押して、この画面を閉じてしまってOKです。

Python 拡張機能（エクステンション）を追加します。拡張機能とは、VS Code に後から追加できる「プラグイン」のようなものです。Python 拡張機能を入れると、VS Code がスクリプトの構文（書き方のルール）に色を付けて表示したり、次の Step で使う仮想環境を管理できるようになります。

左サイドバーの拡張機能アイコン（四角が4つ並んだアイコン）をクリックする
検索欄に「Python」と入力する
Microsoft 製の「Python」拡張機能をクリックして「Install」を押す

Python拡張機能の設定画面が表示されたら、Mark Done（完了） を押して閉じてしまってOKです。

コラム｜VS Code を日本語にしたい場合
VS Code はデフォルトで英語です。日本語のほうが安心な方は、次の手順で日本語化できます。
１. 左サイドバーの拡張機能アイコンをクリックし、検索窓に「Japanese」と入力
２. 「Japanese Language Pack for Visual Studio Code」を [Install] し、右下の再起動ボタンを押す

Step 4：仮想環境を作る

「仮想環境」とは、プロジェクト専用のPython実行環境のことです。

なぜ必要なのか？　Pythonのスクリプトは「ライブラリ」（追加の機能パック）を使います。ライブラリはスクリプトによって必要なバージョンが違い、そのまま混在させると動かなくなることがあります。仮想環境を使うと、スクリプトごとに専用の実行環境を作れるため、他のスクリプトに影響を与えません。Windows 全体のPython環境を汚さずに済む、というのが最大のメリットです。

難しく考えなくて大丈夫です。「スクリプトごとに専用の部屋を作る」というイメージで、VS Code が自動でやってくれます。

VS Code の「環境を作成」機能を使うと、仮想環境の作成を自動で完了できます。

4-0. 実行ポリシーの変更

仮想環境を作成する前に、PowerShellの設定を変更しておきます。

次のコマンドを実行すると、VS Codeがプロジェクトに含まれる仮想環境を認識して、PowerShellが自動で仮想環境に入った状態になります。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

4-1. 仮想環境の作り方

まず、作業フォルダを VS Code で開きます。メニューの 「ファイル（File） → フォルダーを開く（Open Folder）」 からフォルダを選択してください。ドキュメント（Documents）フォルダに「python_scripts」という名前のフォルダを作って、それを開くと良いでしょう（別のフォルダでもOK）。

フォルダを開くときに、「Do you trust ...」のアラートが表示されたら、「Yes, I trust the authors」を選んで許可してください。

次に、仮想環境を作成します。

`Ctrl + Shift + P` を押してコマンドパレット（VS Code への命令入力欄）を開く
「python」と入力して、候補が表示されるのを待つ
「Python: 環境の作成 (Create Environment)」を選択する

４. [venv] を選択する

仮想環境を `venv` を使って作成します。venvは Python仮想環境を作成する標準ツールです。

５. [Python 3.12] を選択する

先ほどインストールした `Python 3.12 (64-bit)` を選びます。複数のPythonバージョンが表示されたときは、適切なものを選びます。

６. [Skip package installation] を選択する

パッケージのインストールは自分で行うため、「Skip package installation」を選びます。

処理が完了すると、フォルダ内に `.venv` というフォルダが生成されます（`.venv` が仮想環境の本体です）。仮想環境の作成はこれで完了です。

4-2. 仮想環境の確認

VS Code の内蔵ターミナルを開きます。メニューの `表示（View） → ターミナル（Terminal）`（または `Ctrl + @`）で表示できます。

行の先頭に `(.venv)` が表示されていれば、ターミナルが仮想環境に入っている状態です。もし表示されていない時は、ターミナル右上の「ゴミ箱」アイコンでターミナルを閉じて、再度開くと、自動で仮想環境に入れます。

次のコマンドを実行します。`pip` でインストール済みのパッケージの一覧を表示できます。

pip list

パッケージをインストールするには `pip install パッケージ名` を使います。試しに代表的な2つをインストールしてみましょう。

pip install numpy requests

numpy：数値計算ライブラリ。配列・行列の演算や統計処理に使われる、データ処理の定番
requests：HTTP通信ライブラリ。URLを指定するだけでWebページのデータを取得できる

再度 `pip list` を実行して、`numpy` と `requests` が一覧に表示されていれば成功です。

`numpy` と `requests` 以外にも複数のパッケージが表示されているはずです。これはパッケージの依存関係によるものです。`numpy` や `requests` 自体が動くために必要な別のパッケージが、自動でまとめてインストールされています。意図して入れていないパッケージが増えていても問題ありません。

4-3. 仮想環境に入れているか、常に確認する

仮想環境は「入った状態」でないとライブラリが使えません。ターミナルの行の先頭に `(.venv)` が表示されているかどうかで確認できます。

VS Code でプロジェクトフォルダを開いた場合、ターミナルを起動すると自動で仮想環境に入った状態になります。`(.venv)` が表示されていれば正常です。

Cursor など、VS Code 以外のアプリでターミナルを開いた場合は、仮想環境に入っていない状態になります。このとき `python` コマンドが使えない、インストールしたはずのパッケージが見つからない、という問題が起きます。

この場合は、プロジェクトフォルダに移動してから次のコマンドを実行します。

.venv\Scripts\activate

行の先頭に `(.venv)` が表示されれば成功です。作業が終わったら次のコマンドで仮想環境から出られます。

deactivate

4-4. requirements.txt でパッケージをまとめてインストールする

スクリプトによっては、プロジェクトフォルダ内に `requirements.txt` というファイルが含まれていることがあります。これは「このスクリプトを動かすために必要なパッケージの一覧」です。

このファイルがある場合は、VS Code のターミナルで以下を実行します。

pip install -r requirements.txt

必要なパッケージがまとめてインストールされます。このファイルがなければ、この手順は不要です。

コラム｜挫折を防ぐ設定：Auto Save
初心者がよくハマる罠があります。スクリプトを書き換えたのに保存し忘れて、古いコードを実行してしまうことです。
VS Code の Auto Save（自動保存）を有効にしておきましょう。メニューの「File（ファイル） → Auto Save（自動保存）」をクリックしてチェックマークがつけば完了です。

Step 5：Pythonを動かしてみる

環境が整ったところで、Pythonを実際に動かしてみましょう。

5-1. インタラクティブシェルを起動する

VS Code のターミナルで `python` とだけ入力して Enter を押します。

python

`>>>` というプロンプトが表示されれば、インタラクティブシェル（Python を1行ずつ試せる実行環境）が起動した状態です。

計算してみる

>>> 1 + 2
3

`1 + 2` と入力して Enter を押すと、すぐに `3` と返ってきます。Python は電卓として使えます。

変数を使ってみる

>>> a = 1
>>> b = 2
>>> c = a + b
>>> print(c)
3

`a = 1` は「a という名前の箱に 1 を入れる」という操作です。これが変数です。`c = a + b` は「a と b を足した結果を c に入れる」。`print(c)` で c の中身を表示します。

インタラクティブシェルを終了する

>>> exit()

`exit()` を入力して Enter を押すと、通常のターミナルに戻ります。

コラム｜スペースは必要か
`a = 1` や `c = a + b` の「`=`」「`+`」の前後にスペースが入っています。このスペースはスクリプトの実行上は不要ですが、読みやすさのために入れる慣習です。Pythonには PEP 8 というコーディング規約があり、スペースの使い方はここで定められています。詳しく知りたい方は「PEP 8」で検索してみてください。

5-2. .pyファイルに書いて実行する

インタラクティブシェルは試し打ち用です。実際のスクリプトは `.py` という拡張子のファイルに書きます。左のサイドバー「エクスプローラー」に表示されているフォルダ名の右側の「ファイル作成」アイコンをクリックして、ファイル名を入力します。

例として `sum100.py` というファイルを作り、以下の内容を書いたとします。一文字ずつ、文字を打ち込んでも良いし、全体をコピー&ペーストしてもかまいません。

# 1から100までの合計を計算するスクリプト
# 「#」で始まる行はコメント。スクリプトの実行には影響しない

total = 0           # 合計を入れる変数。最初は0

for i in range(1, 101):     # iを1から100まで1ずつ増やして繰り返す
    total = total + i       # totalにiを足していく

print(total)        # 結果を表示する

`#` から始まる行はコメントです。スクリプトの実行には影響せず、コードの意味を人間向けに書き添えるためのものです。

これをターミナルから実行します。

python sum100.py

ターミナルに `5050` と表示されれば成功です。1から100まで全部足すと5050になります。コメントと空行を除けば実質4行のコードで完結するのが、Pythonのシンプルさです。

余力のある読者は、1から10000までの計算を行ってみましょう。（答えは、50005000になります。）

これはプログラマーとしての、偉大な第一歩です。たった数行で、人間には面倒な繰り返し計算を一瞬でこなせる。Pythonの応用範囲は無限大で、画像処理・データ分析・Web操作・AI連携まで、ここから先はどこへでも行けます。「もっとやってみたい」と思えたなら、すでにその入り口に立っています。

環境構築、完了です

これで Python スクリプトを動かす準備が整いました。

環境構築は最初の一回だけです。一度できれば、次からは「VS Code を開いてスクリプトを実行する」だけです。

次のステップとして、以下の記事がおすすめです。

付録：仮想環境をやり直す方法

「ライブラリの相性が悪くて動かない」「Pythonのバージョンを変えたい」——そんなときは、仮想環境をまるごと作り直すのが最もシンプルな解決方法です。難しい操作は必要ありません。

手順1：仮想環境を削除する

VS Code のターミナルで、プロジェクトフォルダにいる状態で以下を実行します。

Remove-Item -Recurse -Force .venv

`.venv` フォルダが丸ごと削除されます。これで仮想環境はまっさらな状態に戻ります。スクリプト本体（`.py` ファイル）には影響しません。

手順2：必要なPythonバージョンを用意する

バージョンを変えたい場合は、winget で目的のバージョンをインストールします。

winget install -e --id Python.Python.3.12 --source winget

すでにインストール済みのバージョンであればこの手順は不要です。

手順3：仮想環境を再作成する

Step 4 と同じ手順で仮想環境を作り直します。

`Ctrl + Shift + P` でコマンドパレットを開く
「Python: 環境の作成 (Create Environment)」を選択する
「Venv」を選択する
インタープリターの一覧から、使いたいバージョンを選択する

ここがポイントです。手順2 で新しいバージョンをインストールした場合、一覧にそのバージョンが追加されています。目的のバージョンを選んでください。

「OK」を押せば、新しい `.venv` が作成されます。あとは必要なパッケージを `pip install` で再インストールすれば完了です。

コラム｜仮想環境は使い捨てでいい
仮想環境は気軽に作り直して大丈夫です。壊れたら捨てて作り直す、が正しい使い方です。大事なのはスクリプト本体（`.py` ファイル）であって、仮想環境は何度でも再現できます。「環境が壊れた」と思ったら、まず `.venv` を削除してやり直す。これを覚えておくと、環境構築のトラブルの大半は解決できます。

付録：Windows 10 で winget が使えない場合

Windows 11 には winget が標準搭載されています。Windows 10 をお使いの場合は、以下の手順で winget を使えるようにしてください。

確認：winget が入っているか調べる

PowerShell で以下を実行します。

winget --version

`v1.x.x` のようなバージョン番号が表示されれば、すでに使える状態です。以降の手順は不要です。

「コマンドが見つかりません」のようなエラーが出た場合は、以下の手順でインストールします。

インストール：Microsoft Store から更新する

スタートメニューから「Microsoft Store」を開く
検索欄に「アプリインストーラー」と入力する
「アプリインストーラー」（発行元：Microsoft Corporation）を開いて「更新」または「入手」を押す

インストール完了後、PowerShell を再起動して `winget --version` を再度実行してください。バージョン番号が表示されれば完了です。

Windows 10 バージョン 1709 より前の古いバージョンでは winget が利用できない場合があります。その場合は Windows Update でOSを更新することをおすすめします。