仮想環境は、作っただけではまだ準備の途中です。
その環境を有効化し、ライブラリを入れ、コードを書いて実行してはじめて、「環境を分ける」が手触りのあるものになります。
結論
仮想環境を作ったあとにやることは、順番で見ると整理しやすくなります。
仮想環境を作ったあとにやることは、大きく4つです。
- 有効化する
- ライブラリを入れる
main.pyというファイルを書くpython main.pyで実行する
この順番が大事なのは、pip install も python main.py も、
そのとき有効になっている Python 環境に対して働くからです。
あるある
最初は、文法よりも「どこで作業しているか」で混乱しやすいです。
.venv は作ったのに、そのあと急に手が止まること、けっこうあるのよね。
あるたい。作るところまでは分かっても、その次に何をどこへ置いて、何で動かすかで曖昧になりやすか。
Python の最初の混乱は、文法そのものよりも、
「今の pip と python がどの環境を向いているか」が見えなくなるところで起きやすいです。
だから最初は、作業フォルダを一つ決めて、その中で
「有効化する」「入れる」「書く」「動かす」を小さく一周させます。
本文
最小の流れを、順番に見ていきます。
1. 仮想環境を有効化する
まず、作成済みの仮想環境を有効化します。Windows の PowerShell なら次です。
.venv\Scripts\Activate.ps1
これを実行すると、今開いている端末がその仮想環境を使う状態に切り替わります。
PowerShell の表示は、たとえば次のように変わります。
PS C:\Users\user\my_project> .venv\Scripts\Activate.ps1
(.venv) PS C:\Users\user\my_project>
先頭に (.venv) が付けば、有効化されている状態です。
ここから先の pip と python は、この仮想環境を使う流れになります。
2. pipでライブラリを入れる
次に、必要なライブラリを入れます。今回は pandas を例にします。
pip install pandas
ここで大事なのは、pip install は「いま有効になっている環境」に対して入るということです。
つまり、今の端末が仮想環境を使っているなら、pandas はその仮想環境の中へ入ります。
逆に、有効化せずに同じことをすると、別の Python 環境へ入ってしまうことがあります。
「入れたのに import できない」は、このズレで起きがちです。
3. main.py というファイルを書く
次に、コードを書くための main.py を作ります。
たとえば、作業フォルダの中身は次のようになります。
my_project/
├─ .venv/
└─ main.py
.venv は仮想環境のフォルダです。main.py はコードを書くファイルです。
この2つを同じ階層に置いておくと、最初は流れを追いやすくなります。
main.py の中には、たとえば次のような最小のコードを書きます。
import pandas as pd
df = pd.DataFrame({
"name": ["A", "B", "C"],
"value": [10, 20, 30]
})
print(df)
ここでやっていることは単純です。
pandas を読み込み、簡単な表を 1 つ作って、表示しているだけです。
最初の目的は高度な処理ではありません。
入れたライブラリを、今の環境の Python がちゃんと読めるかを確かめることです。
4. python main.py で実行する
ファイルを書いて保存したら、次は実行です。
python main.py有効化された状態の PowerShell では、たとえば次のように見えます。
(.venv) PS C:\Users\user\my_project> python main.py
name value
0 A 10
1 B 20
2 C 30
ここで先頭に (.venv) が見えているので、このコードは仮想環境の Python で動いています。
実行とは単にコードを走らせることではありません。
どの環境の Python を使ってそのコードを動かすかを、ここで確定させています。
ここでやっと、入れたものと動かすものが同じ箱にそろうわけたい。
うん。だから、仮想環境を作るだけじゃなくて、そこまで通してはじめて意味が見えるのよね。
テンプレ
最小手順だけを抜き出すと、流れはこれです。
.venv\Scripts\Activate.ps1
pip install pandas
python main.py
この3つは別々の操作に見えますが、
実際には「仮想環境に切り替える」「その環境へ入れる」「その環境で動かす」という一続きの流れです。
落とし穴
最初のつまずきは、だいたい環境のズレで説明できます。
ありがちな失敗は、「仮想環境は作ったが、有効化していないまま pip install してしまう」ことです。
すると、ライブラリは別の Python に入ってしまうのに、
自分では今の作業フォルダで入れたつもりになっているので、
後から import できずに混乱しやすくなります。
だから最初は、「今の pip と python はどこを向いているか」を
いつもセットで意識するのが大事です。
「入れたのに読めない」は、Python が意地悪というより、向き先がずれてることが多いのよね。
まずは「今の pip と python はどこを向いとるか」を見る。それだけで、かなり整理しやすかばい。
締め
仮想環境は、作って終わりではなく、使うところまでが一連です。
仮想環境を作ったあとにやることは、難しくありません。
有効化して、ライブラリを入れて、短いコードを書いて、実行する。
まずはその一周を自分の手で通してみることが大切です。
そこまでできると、「環境を分ける」という言葉がかなり具体的になります。
作業ごとにライブラリの置き場所と実行環境をそろえる、その感覚が見えてくるからです。
仮想環境は箱づくりでもあるけど、ほんとうは「向きをそろえる」話でもあるわけたい。
うん。そこが見えれば、最初の混乱はかなり減るよ。まずは小さく一回、ちゃんと動かしてみよう。