ModuleNotFoundError: No module named 'xxx' (venv not activated)

1
2
3
4
5
6
7
8

# 仮想環境を作成
python -m venv venv

# パッケージをインストール（システムPythonに入る）
pip install requests  # NG: 仮想環境が有効化されていない

# スクリプト実行
python main.py  # ModuleNotFoundError

1
2
3
4
5
6
7

# ターミナル1で作業
source venv/bin/activate
pip install requests
# 動作OK

# ターミナル2（新規）で作業
python main.py  # ModuleNotFoundError（有効化を忘れた）

1
2
3
4
5

# Python 3.9で仮想環境を作成
python3.9 -m venv venv

# Python 3.11で実行
python3.11 main.py  # 別のPython

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# Linux/macOS
source venv/bin/activate

# Windows (cmd)
venv\Scripts\activate.bat

# Windows (PowerShell)
venv\Scripts\Activate.ps1

# 有効化の確認（プロンプトに(venv)が表示される）
(venv) $ which python
/path/to/project/venv/bin/python

1
2
3
4
5
6
7
8

# 仮想環境を有効化してから
source venv/bin/activate

# パッケージをインストール
pip install -r requirements.txt

# または個別にインストール
pip install requests flask

1
2
3
4
5

# 仮想環境のPythonを直接使用
./venv/bin/python main.py

# または
/path/to/project/venv/bin/python main.py

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 現在使用中のPythonを確認
which python
# /path/to/project/venv/bin/python なら仮想環境内

# または
python -c "import sys; print(sys.prefix)"
# /path/to/project/venv なら仮想環境内

# インストール済みパッケージを確認
pip list

1
2
3
4
5

// .vscode/settings.json
{
  "python.defaultInterpreterPath": "${workspaceFolder}/venv/bin/python",
  "python.terminal.activateEnvironment": true
}

1
2
3
4
5
6
7
8

# プロジェクトディレクトリに移動したら自動有効化
# .bashrc または .zshrc に追加
cd() {
    builtin cd "$@"
    if [ -f "venv/bin/activate" ]; then
        source venv/bin/activate
    fi
}

1
2
3
4
5
6
7

# パッケージ一覧を保存
pip freeze > requirements.txt

# 新しい環境でインストール
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

1
2
3
4
5
6
7
8

# 実行ポリシーを確認
Get-ExecutionPolicy

# 制限されている場合
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 再度有効化
.\venv\Scripts\Activate.ps1

1
2
3
4
5

# 仮想環境を再作成
rm -rf venv
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

1
2
3

# 仮想環境内でpipをアップグレード
source venv/bin/activate
pip install --upgrade pip

1
2
3
4

# 仮想環境を無効化
deactivate

# プロンプトから(venv)が消える