ITメモベース

Python・開発環境まわりの「つまずきポイント」を整理するITメモ


MacでPythonの仮想環境(venv)が有効化できないときの対処法


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が有効化できない場合は、
次の点を順番に確認してください。

  1. 有効化コマンドが正しいか
  2. 実行しているディレクトリが正しいか
  3. (venv) が表示されているか
  4. VS CodeのPython環境と一致しているか

これらを確認することで、
多くのトラブルは解消できます。

関連記事


コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

PAGE TOP