Python

【Python】「venv」を使ってWSLに仮想環境を構築しよう

takahide

おはようございます。タカヒデです。

本日は、「venvを使ってWSLに仮想環境を構築する方法」を紹介します。

こんな人にオススメ
  • venvの構築方法を使いたい
  • Pythonで仮想環境を構築したい

ぜひ本記事を参考にしながら試してみてください。

そもそも「venv」とは?

「venvって聞いたことあるけどそもそも何だろう…?」という方もいるかと思います。

venvとは、Pythonに標準で用意されている「仮想環境」を作る仕組みです。
仮想環境とは、1つのPCの中にプロジェクト専用のPython実行環境を作ることを指します。

venvを使うことで、

  • プロジェクトで使うPythonの設定
  • インストールしたライブラリ
  • バージョンの違い

これらを他のプロジェクトと完全に切り離して管理できます。
そのためvenvなどの仮想環境は、開発現場では当たり前に使われるものです。

なぜ仮想環境が必要なの?

「いや、そんな仮想環境作らなくてもPCに普通にインストールすればいいやん…」そんな疑問を持ちませんでしたか?

実はそういうわけにはいかないのです。
開発を続けているとプロジェクトごとに「使いたいライブラリ」や「バージョン」が変わってきます。

もし仮想環境を使わず、すべてを1つの環境にインストールしてしまうと

  • Aのアプリでは動いていたのに
  • Bのアプリを作ったら急にエラーが出る
  • ライブラリの更新で別のコードが壊れる

といった問題が起こりやすくなります。
仮想環境を使えば、「1プロジェクト=1環境」という形で管理できるため、こうしたトラブルを防ぐことができるのです。

「venv」を導入し仮想環境を構築する方法

では、実際に「venv」を使って仮想環境を構築する方法を見ていきましょう。

ちなみに私の環境は「WSL」を利用しています。
Windows を利用している場合も流れは同じかと思いますが、コマンドが多少異なる可能性があるのでご注意ください。

STEP1:「venv」用パッケージをインストールする

まず、「venv」を使うためのパッケージをインストールします。

sudo apt update
sudo apt install -y python3-venv

このコマンドにより、Pythonで仮想環境を作成するための機能を有効にします。
パスワードを求められたら設定したものを入力してください。

この操作は、venvを使うための機能をOSに追加する作業です。
一度OSにインストールすればプロジェクト単位ではこのSTEPは不要です。

STEP2:プロジェクトフォルダに移動する

今回のアプリが置いてあるフォルダへ移動します。

cd ~/projects/test

フォルダ名やパスは自分の環境に合わせて修正してください。

STEP3:「venv」を作成する

以下のコマンドでプロジェクト専用の仮想環境を作成します。

python3 -m venv .venv

「.venv」は仮想環境のフォルダ名です。
この名前は慣習的によく使われるようです。

これで仮想環境の構築は完了です。

STEP4:「venv」を有効化する

続けて実際に作成した仮想環境を有効にします。

source .venv/bin/activate

有効化されるとターミナルの表示が次のように変わります。

(.venv) takahide@takahidePC:~/projects/test$

この状態になれば、すべてこのプロジェクト専用の環境になります。
ここからは必要なライブラリインストールや開発を進めてください。

STEP5:「venv」を終了する

作業が終わったら仮想環境を終了できます。

deactivate

ターミナル表示が元に戻ればOKです。

まとめ

以上が「venvを使ってWSLに仮想環境を構築する方法」でした。

手順を解説しているだけなので、今回もまとめることはありません。

この作業はプロジェクト単位で必要になるので、忘れずに設定するようにしましょう。

お疲れさまでした。

ABOUT ME
タカヒデ
タカヒデ
ITを楽しく勉強中
通信会社の企画職で働く30代 非エンジニアでありながら半分趣味でITエンジニアリングやプログラミングを学習中 IT初心者が楽しいと思えるように発信することを目指しています ↓Xもやっているのでフォローしてね
記事URLをコピーしました