読み込み中...
バイブコーディングの前に知っておきたい！Python仮想環境(venv)超入門
バイブコーディングの前に知っておきたい！Python仮想環境(venv)超入門
はじめに
最近話題のバイブコーディング。ChatGPTやClaude、CursorなどのAIに指示を出して、コードを書いてもらうスタイルの開発手法です。
「AIがコード書いてくれるなら、環境構築とか知らなくてよくない？」
...と思いたいところですが、実はここが一番ハマるポイントです。
AIが生成したコードを動かそうとしたら：
ModuleNotFoundError: No module named 'flask'pip install したのに動かない前のプロジェクトが壊れたこんな経験、ありませんか？
これらの問題のほとんどは、仮想環境（venv） を使うだけで解決します。この記事を読めば、venvを完全に理解して、バイブコーディングをスムーズに始められるようになります。
venvってなに？
一言でいうと
プロジェクトごとに独立したPython環境を作る仕組みです。
もう少し詳しく
Pythonでは、pip install でライブラリ（パッケージ）をインストールして機能を追加します。たとえば：
flaskpandasopenai問題は、これらを全部同じ場所にインストールしてしまうと、プロジェクト同士が干渉することです。
具体例：venvなしだと何が起きる？
たとえば、2つのプロジェクトを開発しているとします：
flask 2.0 を使っているflask 3.0 を使いたいvenvなしだと、Pythonのパッケージは1箇所に入ります。プロジェクトBのために pip install flask==3.0 すると、プロジェクトAのflask 2.0が上書きされて壊れます。
1【venvなし：全プロジェクトが同じ環境】
2
3Python（グローバル）
4├── flask 3.0 ← BのためにアップグレードしたらAが壊れた！
5├── pandas 2.1
6├── openai 1.0
7└── ...venvを使えば、プロジェクトごとに完全に分離できます：
1【venvあり：プロジェクトごとに独立】
2
3プロジェクトA/venv/
4├── flask 2.0 ← Aはこっち
5└── pandas 2.1
6
7プロジェクトB/venv/
8├── flask 3.0 ← Bはこっち
9└── openai 1.0お互いに影響しない。 これがvenvの最大のメリットです。
Pythonのインストール確認
venvを使う前に、Pythonがインストールされているか確認しましょう。
ターミナル（コマンドプロンプト）を開いて、以下を実行します：
1python --versionPython 3.10.x のようにバージョンが表示されればOKです。
表示されない場合は、Python公式サイトからインストールしてください。
Windowsの方へ： インストール時に「Add Python to PATH」に必ずチェックを入れてください。これを忘れると、ターミナルから python コマンドが使えません。
venvの使い方（実践）
ステップ1：プロジェクトフォルダを作る
まず、プロジェクト用のフォルダを作ります。
1mkdir my-project
2cd my-projectステップ2：仮想環境を作成する
以下のコマンドで、仮想環境を作成します：
1python -m venv venvpython -m venv → 「Pythonのvenvモジュールを使って」venv → 「venvという名前のフォルダに仮想環境を作って」実行すると、venv フォルダが作成されます：
1my-project/
2└── venv/ ← これが仮想環境
3 ├── bin/ ← Mac/Linux
4 ├── Scripts/ ← Windows
5 ├── lib/ ← パッケージがここに入る
6 └── ...ステップ3：仮想環境を有効化する（activate）
作っただけでは使えません。有効化（activate） する必要があります。
Macの場合：
1source venv/bin/activateWindowsの場合：
1venv\Scripts\activate成功すると、ターミナルの先頭に (venv) と表示されます：
1(venv) $この (venv) が表示されている間は、仮想環境の中にいます。pip install したパッケージは、このプロジェクトの venv フォルダの中だけにインストールされます。
ステップ4：パッケージをインストールする
仮想環境が有効な状態で、好きなパッケージをインストールします：
1pip install flask
2pip install openaiインストールされたパッケージを確認するには：
1pip listステップ5：仮想環境を無効化する（deactivate）
作業が終わったら、仮想環境を抜けます：
1deactivate(venv) の表示が消えたら、グローバル環境に戻っています。
requirements.txt — パッケージの管理
なぜ必要？
バイブコーディングでは、AIが「このパッケージをインストールして」と指示してくることがあります。プロジェクトで使っているパッケージの一覧を記録しておかないと、別のPCで動かすときや、チームメンバーに共有するときに困ります。
作り方
仮想環境が有効な状態で：
1pip freeze > requirements.txtこんなファイルが生成されます：
1flask==3.0.0
2openai==1.12.0
3requests==2.31.0使い方（復元）
別のPCやメンバーがプロジェクトをセットアップするとき：
1python -m venv venv
2source venv/bin/activate # Mac
3pip install -r requirements.txtこれだけで、同じパッケージが同じバージョンでインストールされます。
.gitignore — venvをGitに含めない
venvフォルダはGitにコミットしてはいけません。 中身はパッケージのファイルが大量に入っていて、数百MB〜になることもあります。
プロジェクトのルートに .gitignore ファイルを作り、以下を追加します：
1venv/
2__pycache__/
3*.pyc
4.envパッケージの情報は requirements.txt に記録されているので、venvフォルダ自体は不要です。
バイブコーディングでのvenv活用フロー
AIと一緒に開発するときの、おすすめワークフローです：
新しいプロジェクトを始めるとき
1# 1. フォルダ作成
2mkdir ai-project
3cd ai-project
4
5# 2. venv作成＆有効化
6python -m venv venv
7source venv/bin/activate # Mac
8# venv\Scripts\activate # Windows
9
10# 3. AIに指示を出して開発スタート！
11
12# 4. AIに言われたパッケージをインストール
13pip install flask openai python-dotenv
14
15# 5. 一区切りついたらrequirements.txtを更新
16pip freeze > requirements.txt既存プロジェクトを再開するとき
1# 1. プロジェクトフォルダに移動
2cd ai-project
3
4# 2. venvを有効化
5source venv/bin/activate # Mac
6# venv\Scripts\activate # Windows
7
8# 3. 開発再開！AIに伝えるべきこと
バイブコーディングでAIにコードを書かせるとき、こう伝えると効率的です：
「Python 3.12、venv環境で開発しています。必要なパッケージがあれば教えてください。」
AIが pip install xxx を指示してきたら、venvが有効な状態で実行しましょう。
よくあるトラブルと対処法
1. activate できない（Windows）
症状：
1venv\Scripts\activate : このシステムではスクリプトの実行が無効になっているため...原因： PowerShellの実行ポリシーが制限されている
対処法： PowerShellを管理者として開いて、以下を実行：
1Set-ExecutionPolicy RemoteSigned -Scope CurrentUserその後、もう一度 venv\Scripts\activate を試してください。
2. pip install したのに ModuleNotFoundError
原因： venvが有効化されていない状態で pip install した
確認方法： ターミナルに (venv) が表示されているか確認
対処法：
1# まずvenvを有効化
2source venv/bin/activate # Mac
3# venv\Scripts\activate # Windows
4
5# 改めてインストール
6pip install パッケージ名3. python と python3 どっちを使う？
環境によって異なります。以下で確認：
1python --version
2python3 --versionバージョンが表示される方を使ってください。Macでは python3 の場合が多いです。
その場合、venv作成も：
1python3 -m venv venv4. venvを間違えて削除してしまった
対処法： 作り直すだけでOK！
1python -m venv venv
2source venv/bin/activate
3pip install -r requirements.txtrequirements.txt があれば、パッケージは完全に復元できます。だからこそ、pip freeze > requirements.txt をこまめに実行しておくことが大切です。
5. どのプロジェクトのvenvが有効かわからなくなった
確認方法：
1which python # Mac/Linux
2where python # Windows表示されるパスに、今いるプロジェクトの venv が含まれていればOKです。
まとめ
venvの基本コマンド一覧
| やりたいこと | コマンド |
|---|---|
| 仮想環境を作成 | python -m venv venv |
| 有効化（Mac） | source venv/bin/activate |
| 有効化（Windows） | venv\Scripts\activate |
| 無効化 | deactivate |
| パッケージ追加 | pip install パッケージ名 |
| パッケージ一覧 | pip list |
| 一覧をファイルに保存 | pip freeze > requirements.txt |
| ファイルから一括インストール | pip install -r requirements.txt |
覚えておくべき3つのルール
1. プロジェクトごとにvenvを作る
複数プロジェクトで1つのvenvを共有しない。
2. `(venv)` を確認してから `pip install`
有効化を忘れるとグローバルに入ってしまう。
3. `requirements.txt` をこまめに更新
パッケージを追加したら pip freeze > requirements.txt を実行。
この3つを守るだけで、バイブコーディングでの環境トラブルは激減します。
さあ、venvの準備ができたら、AIと一緒にコードを書いてみましょう！
ロードマップで効率よく学ぼう
バイブコーディングに必要な前提知識を、全8ステップで体系的に学べます。
おすすめのコース
もう怖くない！エラーメッセージの読み方入門
プログラミング初心者が最もつまずく「エラーメッセージ」を徹底攻略します。赤い文字や英語の羅列に怯える必要はもうありません。この無料講座では、Pythonのエラーメッセージの読み方を「下から上へ」のシンプルなルールで解説し、よく出る10大エラーの原因と対処法を具体的なコード例とともに紹介します。エラーを「敵」から「味方」に変えて、バイブコーディングをもっとスムーズに進めましょう。
無料
AIでWebアプリを開発して公開するまでの全体像
AIを使ってWebアプリを作り、実際にインターネットに公開するまでの全体像をわかりやすく解説します。企画→開発→デプロイの流れ、使うツールや技術の選び方、初心者が陥りやすい落とし穴まで、バイブコーディング時代の開発プロセスを俯瞰できるコラムです。
無料
Claude Codeってなに？導入から使い方まで完全ガイド
AIがコードを書いてくれる「Claude Code」を徹底解説。Claude Codeとは何か、何ができるのか、インストール方法から基本的な使い方まで、初心者にもわかりやすくステップバイステップで紹介します。バイブコーディングを始めたい方の最初の一歩に最適な無料講座です。
無料
Claude Codeを使う前に！Node.js導入ガイド
Claude CodeなどのAI開発ツールを使うにはNode.jsが必要です。この無料講座では、Node.jsとは何か、なぜ必要なのかをわかりやすく解説し、Windows・Macそれぞれのインストール手順をステップバイステップで紹介します。npmの基本的な使い方も学べます。
無料