2026年5月17日 / 最終更新日時 : 2026年5月17日 takashide プログラミング

初心者コースその1：Pythonセットアップと仮想環境入門





初心者コースその1：Pythonセットアップと仮想環境入門

Pythonをこれから学ぶ人が、最初につまずきやすい「インストール」「仮想環境」「pip」「VS Codeとの連携」を、
実務で使える形で整理します。

1. Pythonとは何か

Pythonは、読みやすさと扱いやすさを重視したプログラミング言語です。Webアプリ、データ分析、AI、画像処理、
業務自動化、ファイル処理、API連携、PDF処理、Excel操作など、非常に広い用途で使われています。
初心者にとって重要なのは、最初から難しい文法を覚えることではありません。
まずは「Pythonを正しく動かせる環境」を作ることです。

Python学習でよくある失敗は、コードそのものではなく、環境構築で迷子になることです。
たとえば「昨日は動いたのに今日は動かない」「pipで入れたはずのモジュールが見つからない」
「VS Codeでは動かないがコマンドプロンプトでは動く」といった問題です。
これは、Python本体、仮想環境、pip、エディタの関係を理解していないことが原因です。

2. Pythonをインストールする

Pythonを使うには、まずPCにPython本体をインストールします。
Windowsの場合は公式サイトのインストーラを使うのが基本です。
インストール時には「Add Python to PATH」にチェックを入れることが重要です。
これを忘れると、ターミナルで python と入力しても認識されないことがあります。

Windowsでの確認

python --version
python -m pip --version

Windowsでは環境によって python ではなく py コマンドを使う場合もあります。 

py --version
py -m pip --version

macOS / Linuxでの確認

python3 --version
python3 -m pip --version
ポイント：
pipを使うときは、単に pip install と打つよりも、
python -m pip install の形を使うほうが安全です。
どのPythonに対してpipを実行しているかが明確になるためです。

3. 仮想環境とは何か

仮想環境とは、プロジェクトごとにPythonの実行環境を分ける仕組みです。
ここでいう仮想環境は、VirtualBoxやDockerのようなOS丸ごとの仮想化ではありません。
Python本体と、そのプロジェクトで使うモジュール群を分離して管理するための軽量な仕組みです。

たとえば、Aという案件ではFlask 2系を使い、Bという案件ではFlask 3系を使いたいとします。
PC全体に直接モジュールを入れてしまうと、片方の案件を動かすために入れたバージョンが、
もう片方の案件を壊すことがあります。これが「依存関係の衝突」です。
仮想環境を使えば、A案件用の環境、B案件用の環境を分けて管理できます。

管理方法 特徴 初心者へのおすすめ度
PC全体に直接pip install 簡単だが、複数案件で衝突しやすい 低い
venv Python標準機能。軽量で基本を学びやすい 高い
conda データ分析や科学技術計算に強い 用途次第
Docker OSレベルで環境を固定できる 初心者には少し重い

4. なぜvenvを使うのか

venvを使う最大の理由は「環境を壊さないため」です。
Pythonは便利な反面、モジュールのバージョン違いによるトラブルが多い言語でもあります。
特にAI、画像処理、Webアプリ、PDF処理などでは、モジュール同士の依存関係が複雑になります。
何でもPC全体に直接入れる運用は、最初は楽ですが、後から地獄の釜のフタが開きます。

venvを使うメリット

  • 案件ごとにモジュールを分離できる
  • 不要になった環境をフォルダごと削除できる
  • requirements.txtで環境を再現できる
  • VS Codeと連携しやすい
  • 本番環境や別PCへの移行がしやすい

venvは、Python標準ライブラリに含まれるため、追加で大きなツールを入れなくても使えます。
初心者がまず覚えるべき仮想環境はvenvで十分です。
conda、poetry、uv、Dockerなどは便利ですが、最初から全部覚える必要はありません。
まずはvenvとpipの関係を理解しましょう。

5. venvの作り方

作業用フォルダを作り、その中で仮想環境を作ります。
仮想環境のフォルダ名は .venv とするのが一般的です。

Windows

mkdir python_beginner
cd python_beginner
python -m venv .venv

macOS / Linux

mkdir python_beginner
cd python_beginner
python3 -m venv .venv

これで .venv というフォルダが作られます。
この中に、そのプロジェクト専用のPython実行環境が入ります。

仮想環境の有効化

Windows PowerShellの場合：

.venv\Scripts\Activate.ps1

Windows コマンドプロンプトの場合：

.venv\Scripts\activate.bat

macOS / Linuxの場合：

source .venv/bin/activate

有効化されると、ターミナルの先頭に (.venv) のような表示が出ます。
この状態でpipを使うと、PC全体ではなく、この仮想環境の中にモジュールがインストールされます。

仮想環境の終了

deactivate

6. pipとは何か

pipは、Pythonの外部モジュールをインストールするための標準的なツールです。
Pythonには最初から多くの標準ライブラリがありますが、実務では外部モジュールを使うことがほとんどです。
たとえばWebアプリならFlask、データ分析ならpandas、画像処理ならPillowやOpenCV、Excel処理ならopenpyxlを使います。

モジュールのインストール

python -m pip install flask

複数モジュールのインストール

python -m pip install requests pandas matplotlib

インストール済みモジュールの確認

python -m pip list

モジュールの削除

python -m pip uninstall flask
注意：
仮想環境を有効化していない状態でpipを実行すると、意図しない場所にモジュールが入ることがあります。
「入れたはずなのに動かない」問題の多くは、pipを実行したPythonと、実際に動かしているPythonが違うことにあります。

7. requirements.txtで環境を記録する

Python開発では、使っているモジュールを requirements.txt に記録します。
これは「このプロジェクトを動かすには、どのモジュールが必要か」を示す一覧表です。
他のPCやサーバーで同じ環境を作るときに使います。

現在の環境を記録する

python -m pip freeze > requirements.txt

requirements.txtから一括インストールする

python -m pip install -r requirements.txt

たとえば、Flaskアプリを別のPCに渡す場合、ソースコードだけでは動きません。
Flaskやその他の依存モジュールも必要です。
そのため、プロジェクトには通常、以下のような構成を用意します。 

my_project/
  app.py
  requirements.txt
  .venv/          ← Gitには通常入れない
  templates/
  static/

.venv は環境そのものなので、通常はGitや配布物には含めません。
代わりに requirements.txt を渡して、相手のPCで再構築します。

8. VS Codeとの関係

VS CodeはPython専用ソフトではなく、さまざまな言語に対応した高機能エディタです。
Python開発で使う場合は、MicrosoftのPython拡張を入れることで、入力補完、デバッグ、実行、テスト、
仮想環境の切り替えなどが使いやすくなります。

初心者が理解すべき点は、VS CodeそのものがPythonを動かしているわけではない、ということです。
VS Codeは、PCに入っているPythonやvenvのPythonを選択して、それを使って実行しています。
つまり、VS Codeで正しい仮想環境を選ばないと、ターミナルでは動くのにVS Codeでは動かない、ということが起きます。

VS Codeで行う基本設定

  1. プロジェクトフォルダを開く
  2. Python拡張機能をインストールする
  3. コマンドパレットを開く
  4. Python: Select Interpreter を選ぶ
  5. .venv 内のPythonを選択する

ここで .venv のPythonを選ぶことが重要です。
Windowsなら .venv\Scripts\python.exe、
macOSやLinuxなら .venv/bin/python のようなパスになります。

9. 初心者が覚えるべき代表的な標準ライブラリ

Pythonには、最初から使える標準ライブラリが多数あります。
標準ライブラリはpipで追加インストールしなくても使えます。

ライブラリ 用途
os ファイル、フォルダ、環境変数の操作
pathlib パス操作。初心者にはos.pathより扱いやすい
json JSONファイルやAPIデータの読み書き
csv CSVファイルの読み書き
datetime 日付、時刻の処理
logging ログ出力。print卒業の第一歩
sqlite3 軽量データベースSQLiteの操作
argparse コマンドライン引数の処理

10. pipで入れる代表的な外部モジュール

実務では外部モジュールを使うことで、開発速度が大きく上がります。
ただし、何でも入れればよいわけではありません。
必要なものを仮想環境に入れ、requirements.txtで管理するのが基本です。

モジュール 用途 インストール例
requests Web APIやHTTP通信 python -m pip install requests
flask 小〜中規模Webアプリ開発 python -m pip install flask
fastapi APIサーバー開発 python -m pip install fastapi uvicorn
pandas 表データ、CSV、Excel系データ分析 python -m pip install pandas
numpy 数値計算、配列処理 python -m pip install numpy
matplotlib グラフ作成 python -m pip install matplotlib
openpyxl Excelファイルの読み書き python -m pip install openpyxl
Pillow 画像の読み込み、変換、リサイズ python -m pip install pillow
opencv-python 画像処理、動画処理、AI前処理 python -m pip install opencv-python
pytest 自動テスト python -m pip install pytest
python-dotenv .envファイルから設定値を読み込む python -m pip install python-dotenv

11. 最小サンプル：Flaskを動かす

仮想環境とpipの関係を理解するために、簡単なFlaskアプリを作ります。

手順

mkdir flask_sample
cd flask_sample
python -m venv .venv

# Windows
.venv\Scripts\Activate.ps1

# macOS / Linux
source .venv/bin/activate

python -m pip install flask
python -m pip freeze > requirements.txt

app.py

from flask import Flask

app = Flask(__name__)

@app.route("/")
def index():
    return "Hello, Python beginner!"

if __name__ == "__main__":
    app.run(debug=True)

実行

python app.py

ブラウザで http://127.0.0.1:5000 を開き、
Hello, Python beginner! と表示されれば成功です。

12. よくあるトラブルと対処

ModuleNotFoundErrorが出る

原因の多くは、モジュールを入れた環境と、実行しているPythonが違うことです。
まず次のコマンドで確認します。 

python -c "import sys; print(sys.executable)"
python -m pip list

VS Codeでだけ動かない

VS Codeが別のPythonを見ている可能性があります。
Python: Select Interpreter から .venv のPythonを選び直します。

PowerShellでActivate.ps1が実行できない

Windowsの実行ポリシーにより、PowerShellスクリプトがブロックされている場合があります。
学習用PCでは、以下で現在ユーザーのみ許可する方法があります。 

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

pip installで失敗する

Pythonのバージョン、OS、CPU、モジュールの対応状況が関係することがあります。
まずpipを更新します。 

python -m pip install --upgrade pip setuptools wheel

13. 初心者におすすめの基本運用

Python初心者は、次の運用を習慣にするとトラブルが激減します。

  1. プロジェクトごとにフォルダを分ける
  2. 各プロジェクトに .venv を作る
  3. pipは必ず python -m pip 形式で使う
  4. VS Codeでは必ずインタープリタを確認する
  5. 動いたら requirements.txt を作る
  6. .venv は配布しない
  7. エラーが出たら、まずPythonの場所を確認する

Pythonの環境構築は、最初は面倒に見えます。
しかし、venv、pip、VS Codeの関係がわかると、以後の開発がかなり安定します。
逆にここを曖昧にすると、コードを書く前に環境で詰まります。
プログラミング学習の最初の敵は文法ではありません。だいたい環境です。

14. まとめ

Pythonを学ぶ第一歩は、文法暗記ではなく、正しい作業環境を作ることです。
Python本体を入れ、プロジェクトごとにvenvを作り、pipで必要なモジュールを入れ、
VS Codeで正しいインタープリタを選ぶ。この流れを身につければ、Webアプリ、AI、データ分析、
業務自動化など、次の学習にスムーズに進めます。

初心者コースその1では、まず「Pythonを安全に動かせる土台」を作ることが目的です。
ここが固まれば、次は変数、条件分岐、繰り返し、関数、ファイル操作、Webアプリ開発へ進めます。
土台がしっかりしていれば、あとから大きなアプリを作るときにも崩れません。

この教材は、Python初心者が最初に理解すべき「Python本体」「venv」「pip」「VS Code」の関係を整理したものです。
次のステップでは、Python文法の基礎、ファイル操作、Web API連携、Flaskによる簡易アプリ開発へ進むと効果的です。



カテゴリー
プログラミング
タグ

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA


AI

前の記事

ローカルLLMの可能性と応用事例
2026年4月11日
プログラミング

次の記事

超初心者入門：開発言語って何？なぜPythonなのか？New!!
2026年5月17日