【Python】標準仮想環境「venv」の使い方|作成・有効化・無効化まとめ

環境&ワークフロー

Pythonの標準仮想環境 venv とは?

Pythonで開発を行う際、「プロジェクトごとに異なるバージョンのライブラリを使いたい」「システムのPython環境を汚したくない」といった場面が多々あります。venvは、Python 3.3以降に標準で組み込まれている仮想環境作成ツールです。これを使うことで、プロジェクトごとに完全に独立・隔離されたPython環境を構築できます。

追加のインストールなしですぐに使えるため、Python開発の基本かつ必須のツールとなっています。

仮想環境の作成方法

ターミナル(またはコマンドプロンプト)を開き、対象のプロジェクトディレクトリに移動して以下のコマンドを実行します。一般的に、仮想環境のディレクトリ名は .venvvenv とするのが定番です。

python -m venv venv

※ MacやLinuxなど、OSの環境によっては python3 と指定する必要があります。

python3 -m venv venv

仮想環境の有効化(アクティベート)

作成した仮想環境を利用するには、まず「有効化(アクティベート)」する必要があります。OSによって実行するコマンドが異なります。

Mac / Linuxの場合

source venv/bin/activate

Windowsの場合

PowerShellまたはコマンドプロンプトで以下を実行します。

.\venv\Scripts\activate

※ PowerShellを利用していて「スクリプトの実行が許可されていない」というエラーが出る場合は、管理者権限で Set-ExecutionPolicy Unrestricted -Scope CurrentUser などのコマンドを実行して実行ポリシーを変更してください。

有効化に成功すると、ターミナルの行頭に (venv) というように仮想環境名が表示されるようになります。

パッケージのインストール手順

仮想環境が有効化されている状態で pip コマンドを使うと、システム全体ではなく現在の仮想環境専用にパッケージがインストールされます。

pip install パッケージ名

より確実で安全な方法として、以下のように python -m を付けて実行する形式も推奨されています。

python -m pip install パッケージ名

これで、他のプロジェクトと競合することなく必要なライブラリを利用できます。

仮想環境の無効化(ディアクティベート)

プロジェクトの作業を終えて通常のシステム環境に戻りたい場合は、以下のコマンドを実行します。

deactivate

コマンドを実行すると行頭の (venv) という表示が消え、仮想環境が無効化されたことが確認できます。

まとめ

venv を利用すれば、システム環境を汚すことなく、プロジェクトごとに安全で独立したPython環境を簡単に用意できます。

  • 作成: python -m venv venv
  • 有効化 (Mac/Linux): source venv/bin/activate
  • 有効化 (Windows): .\venv\Scripts\activate
  • 無効化: deactivate

Pythonで新しいプロジェクトを始める際は、まず venv で仮想環境を作成する習慣をつけることをおすすめします。

Bash玄

はじめまして!Bash玄です。

エンジニアとしてシステム運用に携わる中で、手作業の多さに限界を感じ、Bashスクリプトを活用して業務を効率化したのがきっかけで、この道に入りました。「手作業は負け」「スクリプトはシンプルに」をモットーに、誰でも実践できるBashスクリプトの書き方を発信しています。

このサイトでは、Bashの基礎から実践的なスクリプト作成まで、初心者でもわかりやすく解説しています。少しでも「Bashって便利だな」と思ってもらえたら嬉しいです!

# 好きなこと
- シンプルなコードを書くこと
- コマンドラインを快適にカスタマイズすること
- 自動化で時間を生み出すこと

# このサイトを読んでほしい人
- Bashに興味があるけど、何から始めればいいかわからない人
- 定型業務を自動化したい人
- 効率よくターミナルを使いこなしたい人

Bashの世界に一歩踏み出して、一緒に「Bash道」を極めていきましょう!

Bash玄をフォローする

コメント