MacでPythonの仮想環境を使おうとして、
次のような状況で止まってしまったことはありませんか。
- venvを作成したが、有効化されていない気がする
- activateを実行しても何も変わらない
- pip installしても反映されない
Pythonの仮想環境(venv)は便利な仕組みですが、
初期段階ではつまずきやすいポイントでもあります。
この記事では、Mac環境でvenvが有効化できないときに確認すべき原因と対処法を、
初心者向けに分かりやすく解説します。
この記事でわかること
- Pythonの仮想環境(venv)とは何か
- venvを作成・有効化する基本手順
- Macで有効化できない主な原因
- よくある勘違いと確認ポイント
※ 本記事は Mac環境(python3) を前提に説明します。
Pythonの仮想環境(venv)とは
仮想環境(venv)とは、
プロジェクトごとにPythonの実行環境を分ける仕組みです。
venvを使うことで、
- ライブラリの競合を防げる
- プロジェクトごとに環境を管理できる
といったメリットがあります。
venvを作成する基本手順
まずは、仮想環境を作成します。
python3 -m venv venv
このコマンドを実行すると、venv というフォルダが作成されます。
venvを有効化する方法(Mac)
作成した仮想環境を有効化するには、次のコマンドを実行します。
source venv/bin/activate
有効化されると、
ターミナルの表示が次のように変わります。
(venv)
この表示が出ていれば、仮想環境は有効になっています。
原因① 有効化コマンドを間違えている
Macでは、Windowsとは有効化コマンドが異なります。
- Windows
venv\Scripts\activate - Mac
source venv/bin/activate
Windows用のコマンドをそのまま使ってしまうと、
venvは有効化されません。
原因② 仮想環境を作成した場所と違う場所で実行している
venvは、作成したディレクトリ内で有効化する必要があります。
確認ポイント
- 現在いるディレクトリは正しいか
venvフォルダが存在しているか
次のコマンドで確認できます。
ls
一覧に venv が表示されていなければ、
別の場所に移動している可能性があります。
原因③ 仮想環境を有効化していない状態でpip installしている
venvを使っている場合、
有効化していない状態でpip installを実行すると、
グローバル環境にインストールされてしまいます。
結果として、
- インストールしたはずなのに使えない
- ModuleNotFoundErrorが出る
といった状況になります。
pip install の前に、
必ずターミナルに (venv) が表示されているか確認してください。
原因④ VS Codeのターミナルと環境が一致していない
VS Codeでは、
- エディタ上で選択しているPython
- ターミナルで使っているPython
が一致していないことがあります。
確認ポイント
- VS Code下部に表示されているPythonのバージョン
- 仮想環境のPythonが選択されているか
必要に応じて、Pythonの選択を切り替えてください。
よくある勘違い
- venvを作っただけで有効になっていると思っている
- ターミナルを開き直しても自動で有効になると思っている
- プロンプト表示を見ていない
仮想環境は、
毎回手動で有効化する必要がある点に注意が必要です。
まとめ
Macでvenvが有効化できない場合は、
次の点を順番に確認してください。
- 有効化コマンドが正しいか
- 実行しているディレクトリが正しいか
(venv)が表示されているか- VS CodeのPython環境と一致しているか
これらを確認することで、
多くのトラブルは解消できます。
コメントを残す